Spring Boot 3 WebFlux应用缺失http.metrics指标求助

可能的原因及排查步骤 #

1. 检查HTTP指标自动配置是否被禁用 #

确认配置文件中没有手动关闭指标采集的配置：

management.metrics.web.server.autotime.enabled=false

该配置默认值为true，若手动设为false会直接关闭WebFlux的HTTP请求指标采集。

2. 验证WebFlux指标自动配置类是否生效 #

查看应用启动日志，搜索WebFluxMetricsAutoConfiguration或MetricsWebFilter关键字，确认这些组件被Spring容器加载。如果未找到相关加载记录，可能是：

• Web适配器模块不在Spring Boot组件扫描范围内：检查主启动类的@ComponentScan注解是否包含Web适配器所在的包路径；
• 自动配置被显式排除：确认项目中没有使用@EnableAutoConfiguration(exclude = WebFluxMetricsAutoConfiguration.class)这类配置排除该自动配置类。

3. 排查自定义Web组件的影响 #

如果项目中有自定义的WebFilter、RouterFunction或WebExceptionHandler，需检查：

• 自定义Filter的优先级是否覆盖了MetricsWebFilter：默认MetricsWebFilter的优先级为Ordered.HIGHEST_PRECEDENCE + 10，若自定义Filter的优先级更高（数值更小），可能导致请求未经过指标采集Filter；
• 是否存在全局请求拦截逻辑，导致请求未正常流经MetricsWebFilter。

4. 确认依赖配置完整性 #

虽然你已添加必要依赖，可再次确认版本一致性（Spring Boot 3.0.4对应Micrometer版本为1.11.4）：

implementation("org.springframework.boot:spring-boot-starter-webflux:3.0.4")
implementation("org.springframework.boot:spring-boot-starter-actuator:3.0.4")
implementation("io.micrometer:micrometer-registry-prometheus:1.11.4")

避免版本冲突导致自动配置失效。

额外验证步骤 #

• 临时简化Web适配器配置：移除自定义的WebFilter、RouterFunction等组件，重启应用后再次访问/actuator/prometheus，查看http指标是否出现；
• 添加日志调试：在Web适配器中添加请求日志，确认请求是否正常进入WebFlux处理流程，排除请求未到达WebFlux层的可能。

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