断路器属性配置

您可以在应用程序的配置文件中配置 CircuitBreaker 和 TimeLimiter 配置或实例。属性配置的优先级高于 Java Customizer 配置。

优先级从高到低排序。

  • 方法(id) 配置 - 用于特定方法或操作

  • 服务(组) 配置 - 用于特定应用程序服务或操作

  • 全局默认配置

ReactiveResilience4JCircuitBreakerFactory.create(String id, String groupName)
Resilience4JCircuitBreakerFactory.create(String id, String groupName)

全局默认属性配置

resilience4j.circuitbreaker:
    configs:
        default:
            registerHealthIndicator: true
            slidingWindowSize: 50

resilience4j.timelimiter:
    configs:
        default:
            timeoutDuration: 5s
            cancelRunningFuture: true

配置属性配置

resilience4j.circuitbreaker:
    configs:
        groupA:
            registerHealthIndicator: true
            slidingWindowSize: 200

resilience4j.timelimiter:
    configs:
        groupC:
            timeoutDuration: 3s
            cancelRunningFuture: true

实例属性配置

resilience4j.circuitbreaker:
 instances:
     backendA:
         registerHealthIndicator: true
         slidingWindowSize: 100
     backendB:
         registerHealthIndicator: true
         slidingWindowSize: 10
         permittedNumberOfCallsInHalfOpenState: 3
         slidingWindowType: TIME_BASED
         recordFailurePredicate: io.github.robwin.exception.RecordFailurePredicate

resilience4j.timelimiter:
 instances:
     backendA:
         timeoutDuration: 2s
         cancelRunningFuture: true
     backendB:
         timeoutDuration: 1s
         cancelRunningFuture: false

  • ReactiveResilience4JCircuitBreakerFactory.create("backendA") 或 Resilience4JCircuitBreakerFactory.create("backendA") 将应用 instances backendA properties

  • ReactiveResilience4JCircuitBreakerFactory.create("backendA", "groupA") 或 Resilience4JCircuitBreakerFactory.create("backendA", "groupA") 将应用 instances backendA properties

  • ReactiveResilience4JCircuitBreakerFactory.create("backendC") 或 Resilience4JCircuitBreakerFactory.create("backendC") 将应用 global default properties

  • ReactiveResilience4JCircuitBreakerFactory.create("backendC", "groupC") 或 Resilience4JCircuitBreakerFactory.create("backendC", "groupC") 将应用 global default CircuitBreaker properties 和 config groupC TimeLimiter properties

有关 Resilience4j 属性配置的更多信息，请参阅Resilience4J Spring Boot 2 配置。

禁用 TimeLimiter

默认情况下，TimeLimiter 是启用的，并且每个执行都有时间限制作为后盾。此时间限制可以是显式定义的，也可以使用默认时间限制（由 io.github.resilience4j.timelimiter.TimeLimiterConfig#ofDefaults 提供）。

通过将属性 spring.cloud.circuitbreaker.resilience4j.disable-time-limiter 设置为 true，可以在全局范围内禁用 TimeLimiter。

spring:
	cloud:
		circuitbreaker:
			resilience4j:
				disable-time-limiter: true

TimeLimiter 也可以使用 spring.cloud.circuitbreaker.resilience4j.disable-time-limiter-map 按如下方式针对特定组或实例禁用

spring:
	cloud:
		circuitbreaker:
			resilience4j:
				disable-time-limiter-map:
					group1: true
					instanceA: false
					instanceB: true

这些禁用 TimeLimit 的选项在 spring-cloud-circuitbreaker 中提供，适用于基本和响应式断路器实现。

禁用优先顺序为：instance > group > global。根据上述配置，instanceB 和 group1 禁用了 TimeLimiter，但 instanceA 启用了。对于所有其他实例和组，将回退到全局设置的 spring.cloud.circuitbreaker.resilience4j.disable-time-limiter 值。如果未设置 spring.cloud.circuitbreaker.resilience4j.disable-time-limiter，默认情况下，其余断路器实例和组将启用 TimeLimit。