为方法添加@Counted注解导致Spring Boot项目测试失败求助

问题根源 #

@Counted是基于Spring AOP实现的指标采集，而你的方法返回Mono/Flux这类Reactor响应式类型，在测试环境中，AOP代理处理响应式方法时，JoinPoint参数绑定逻辑出现异常，触发了报错。@Timed能正常工作，是因为它在WebFlux环境下通过WebFilter或Reactor上下文实现，不依赖AOP的JoinPoint绑定逻辑。

解决方法 #

1. 升级Micrometer版本 #

部分旧版本的Micrometer（比如1.9.x及以下）在处理响应式方法的@Counted注解时，存在测试环境AOP绑定的bug，升级到1.10.x及以上的稳定版即可解决，修改pom.xml或build.gradle中的依赖版本即可。

2. 显式配置CountedAspect #

手动注册CountedAspect，规避自动配置在测试环境的异常：

@Configuration
public class MicrometerConfig {
    @Bean
    public CountedAspect countedAspect(MeterRegistry meterRegistry) {
        return new CountedAspect(meterRegistry);
    }
}

3. 调整测试类配置 #

在测试类添加@AutoConfigureMetrics注解，确保测试环境的Metrics配置正确加载：

@SpringBootTest
@AutoConfigureMetrics
public class YourServiceTest {
    // 测试逻辑
}

4. 避免Mockito直接Mock代理Bean #

如果测试中用@MockBean替换了被@Counted注解的Bean，会丢失Spring的AOP代理，导致切面无法生效且触发报错。建议改用@SpyBean保留原Bean的代理逻辑，或者直接注入真实Bean进行测试。

5. 测试环境临时禁用@Counted切面 #

如果不需要在测试中验证@Counted指标，可以让CountedAspect仅在非测试环境生效：

@Configuration
@Profile("!test")
public class MicrometerConfig {
    @Bean
    public CountedAspect countedAspect(MeterRegistry meterRegistry) {
        return new CountedAspect(meterRegistry);
    }
}

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