Spring Boot 2.7.0无法暴露http.server.request指标的解决办法咨询

核心原因 #

Spring Boot 2.4+版本后，http.server.requests指标采用懒加载机制，只有当实际有HTTP请求到达应用后才会生成并暴露；另外部分默认配置的细微调整也可能导致指标未被正常启用。

解决方案步骤 #

1. 先发起实际HTTP请求 #

访问你的应用任意接口（比如业务接口或/actuator/health），之后重新访问/actuator/metrics，此时应该能看到http.server.requests指标。

2. 补充必要配置 #

如果发起请求后仍未显示，在application.yml中添加以下配置确保指标启用：

management:
  metrics:
    enable:
      http:
        server:
          requests: true # 显式启用HTTP服务器请求指标
    web:
      server:
        request:
          metric-name: http.server.requests # 确保指标名称未被自定义修改，默认值即为该值，可省略但需确认无冲突配置

3. 检查依赖与自动配置 #

• 确保项目包含spring-boot-starter-web依赖（Web MVC的HTTP指标采集依赖该Starter）：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

• 检查是否存在自定义配置排除了WebMvcMetricsAutoConfiguration自动配置类，若有则移除排除规则，该类负责自动配置Web MVC的请求指标采集逻辑。

4. 直接查看Prometheus端点 #

可以直接访问/actuator/prometheus端点，该端点会输出所有Prometheus格式的指标，包括http_server_requests_*系列的直方图指标，比/actuator/metrics更直观。

为什么降级到2.3.7能解决？ #

Spring Boot 2.3.x版本中，http.server.requests指标在应用启动后就会初始化（即使无请求），而2.4+版本改为懒加载模式，只有在请求触发后才生成指标，这是版本间的行为差异，并非功能缺失。

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