You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Spring Boot 2 Actuator健康检查API能否移除actuator路径前缀?

移除Spring Boot 2 Actuator的/actuator前缀,兼容原有健康检查路径

没问题!Spring Boot 2.x对Actuator组件做了重构,默认把所有端点都挂载到了/actuator前缀下,这就是你升级后路径变化的原因。不过完全可以通过配置改回原来的路径,不用修改第三方健康检查客户端的配置,下面给你两种实用方案:

方案一:全局移除/actuator前缀(所有端点都用根路径)

如果你希望所有Actuator端点(比如/health、/info等)都直接暴露在根路径下,只需要在你的配置文件里添加management.endpoints.web.base-path: /即可。结合你现有的配置,完整的yaml配置如下:

management:
  server:
    context-path: /
    port: 50186
  endpoints:
    web:
      base-path: /  # 关键配置:移除/actuator前缀
  endpoint:
    health:
      enabled: true  # 确保健康检查端点开启(默认已开启,可按需调整)
      show-details: always  # 可选,控制健康检查详情的显示策略,比如只给内部访问显示详情

配置完成后,你的健康检查路径就会变回mydomain:50186/health,和之前完全一致,第三方客户端无需任何改动。

方案二:仅为/health端点映射路径(其他端点保留/actuator前缀)

如果你只想让健康检查路径兼容原有配置,其他Actuator端点还保留/actuator前缀,可以用路径映射的方式单独配置/health:

management:
  server:
    context-path: /
    port: 50186
  endpoints:
    web:
      base-path: /actuator  # 其他端点仍保留/actuator前缀
      path-mapping:
        health: /health  # 将/actuator/health映射到根路径的/health

这样配置后,/health可以直接访问,而其他端点比如/info还是需要通过/actuator/info访问,适合只需要兼容健康检查场景的需求。

注意事项

  • 确认management.endpoint.health.enabled为true(默认就是true,如果你之前修改过Actuator的全局配置,记得检查)
  • 如果你的应用使用了Spring Security,要确保安全配置允许/health路径的匿名访问,避免第三方客户端被拦截
  • 配置完成后,记得启动应用测试一下http://mydomain:50186/health是否能正常返回健康检查响应

内容的提问来源于stack exchange,提问作者Arpan Das

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.26 07:04:07