配置show-details后Spring Boot Actuator健康探测端点响应异常问询

结论先行 #

这绝对不是预期行为，是Spring Boot健康分组配置里的一个容易踩的坑，核心是没搞清楚show-details配置背后的逻辑。

问题根源 #

你配置management.endpoint.health.group.liveness/readiness.show-details = always的时候，无意中修改了健康分组的状态计算规则：

• 默认情况下，/actuator/health/liveness和/actuator/health/readiness只看对应的LivenessStateHealthIndicator和ReadinessStateHealthIndicator的状态，外部依赖（比如RabbitMQ）挂了根本不影响这俩端点的状态码，返回200才是符合Kubernetes探针设计的——liveness管Pod活不活，readiness管能不能接流量，外部依赖挂了不该直接判定Pod死了或者不能接流量。
• 但一旦开了show-details=always，Spring Boot会自动把所有健康检查组件（包括RabbitMQ这类外部依赖的）都塞进这个分组里。这时候只要有一个组件状态是DOWN，整个分组的状态就会变成DOWN，HTTP状态码自然就返回503了。
• 至于响应体里的"readinessState": {"status": "UP"}，是因为单独的ReadinessState指示器本身没问题，但整体分组的状态被RabbitMQ的DOWN给覆盖了，属于细节展示里的单独指标。

正确的配置姿势 #

如果既想展示这俩端点的详情，又不想让外部依赖干扰探针状态，必须明确指定分组只包含对应的状态指示器：

# Liveness分组只看自身状态，同时开启详情
management.endpoint.health.group.liveness.include=livenessState
management.endpoint.health.group.liveness.show-details=always

# Readiness分组同理
management.endpoint.health.group.readiness.include=readinessState
management.endpoint.health.group.readiness.show-details=always

这样配置后，不管外部依赖怎么挂，liveness/readiness的状态码都只由Pod自身的存活/就绪状态决定，完全符合Kubernetes探针的判定逻辑，同时还能看到详情内容。

补充提醒 #

Spring Boot官方文档里其实提过，健康分组如果没指定include属性，开启show-details后会默认包含所有健康指示器。这个细节很容易被忽略，也是很多人踩坑的原因。

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