使用@CircuitBreaker注解时出现NPE问题求助

问题场景 #

在Spring Cloud微服务架构中，order-service通过@CircuitBreaker注解集成Resilience4j实现熔断逻辑，调用inventory-service接口。原本服务运行正常，添加注解后出现NullPointerException，导致Spring上下文无法加载OrderService Bean。

问题根源 #

OrderController中的placeOrder方法被定义为private，而Resilience4j的熔断逻辑依赖Spring AOP实现方法增强，Spring AOP无法为私有方法生成代理对象。这会导致Spring无法正确初始化Controller的代理实例，进而引发依赖注入时的NullPointerException。

解决方案 #

将placeOrder方法的访问修饰符从private改为public：

@RestController
@RequestMapping("/api/order")
@RequiredArgsConstructor
public class OrderController {

    private final OrderService orderService;

    @PostMapping
    @ResponseStatus(HttpStatus.CREATED)
    @CircuitBreaker(name = "inventory", fallbackMethod = "fallbackMethod")
    // 修改为public访问权限
    public String placeOrder(@RequestBody OrderRequest orderRequest) {
        orderService.placeOrder(orderRequest);
        return "Order placed successfully!";
    }

    public String fallbackMethod(OrderRequest orderRequest, RuntimeException runtimeException) {
        return "Oops! Something went wrong, please order after some time!";
    }
}

关键说明 #

1. AOP代理限制：Spring AOP仅支持对public方法进行代理增强，私有、protected方法无法被拦截，因此Resilience4j的注解无法生效，还会破坏Bean的初始化流程。
2. Fallback方法要求：fallback方法必须保持public访问权限，且方法签名需与被熔断方法匹配（参数列表一致，额外增加一个异常类型的参数），你的现有代码已满足该要求。
3. 配置验证：application.properties中的Resilience4j配置项无问题，无需调整。

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