使用Resilience4J时提示CircuitBreaker cannot be resolved to a type如何解决

1. 清理冲突冗余依赖 #

你的pom.xml存在两个核心依赖问题：

• spring-cloud-starter-circuitbreaker-reactor-resilience4j是Spring Cloud针对WebFlux响应式栈封装的熔断组件，你使用RestTemplate属于Servlet栈，该依赖完全无用且会和原生Resilience4j注解冲突，直接删除。
• resilience4j-core、resilience4j-circuitbreaker、resilience4j-all属于重复引入，resilience4j-spring-boot2已经包含所需的基础组件，重复引入会导致版本冲突风险。

清理后只需保留以下相关依赖即可：

<!-- Resilience4j Spring Boot2 适配 -->
<dependency>
    <groupId>io.github.resilience4j</groupId>
    <artifactId>resilience4j-spring-boot2</artifactId>
    <version>1.7.0</version>
</dependency>
<!-- AOP是Resilience4j注解生效的必要依赖 -->
<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-aop</artifactId>
  <version>2.3.1.RELEASE</version>
</dependency>

依赖修改后执行Maven的reload操作，刷新项目依赖。

2. 修正导入语句 #

你使用的import io.github.resilience4j.*通配符无法导入子包内的类，需显式导入以下两个类：

import io.github.resilience4j.circuitbreaker.annotation.CircuitBreaker;
import io.github.resilience4j.circuitbreaker.CircuitBreakerConfig;

修改后IDE的无法解析报错就会消失。

3. 修正fallback方法签名（运行时必改项） #

你当前的fallback方法不符合Resilience4j的规则，运行时会抛出找不到fallback方法的异常，规则如下：

• fallback方法返回值必须和原方法完全一致，你的原方法createAccount返回值是void，fallback也必须是void
• fallback方法的入参必须包含原方法的所有入参，还可以追加一个Throwable类型的参数接收触发熔断的异常

修正后的代码示例：

@Service
public class AccountServiceImpl implements AccountService {

    @Autowired 
    private RestTemplate restTemplate;

    @CircuitBreaker(name = "test", fallbackMethod = "fallback")   
    public void createAccount(ConsentRequestDTO consent) {
        // 调用第二个应用的POST请求逻辑
        restTemplate.postForObject("http://第二个应用的地址/接口", consent, String.class);
    }

    public void fallback(ConsentRequestDTO consent, Throwable e) {
        // 这里可以自定义错误提示、打印异常日志
        System.out.println("下游应用不可用，触发熔断：" + e.getMessage());
    }
}

4. 可选配置（application.yml） #

可以在配置文件中自定义熔断规则，比如失败阈值、熔断时长等：

resilience4j:
  circuitbreaker:
    instances:
      test:
        failure-rate-threshold: 50 # 失败率达到50%触发熔断
        wait-duration-in-open-state: 10000 # 熔断10秒后进入半开状态
        sliding-window-size: 10 # 统计窗口大小为10次请求

内容的提问来源于stack exchange，提问作者shurohige