Spring Boot Actuator 3.x.x健康贡献者不存在时报错，如何禁用？

核心原因 #

Spring Boot Actuator 3.x 调整了健康检查的默认行为，启用了严格模式：当配置中引用的健康贡献者（health contributor）对应的Bean不存在时，会直接抛出运行时异常；而2.x版本默认是宽松模式，会自动忽略不存在的贡献者，不会触发报错。

禁用报错的具体方法 #

方法1：切换为宽松注册模式 #

在配置文件中添加参数，让Actuator回到2.x的宽松校验逻辑：

• 若使用application.properties：

  management.health.contributor-registration-mode=relaxed
  

• 若使用application.yml：

  management:
    health:
      contributor-registration-mode: relaxed
  

该配置会让Actuator忽略不存在的健康贡献者，不再抛出异常。如果同时启用了存活/就绪探针，还可以关闭探针的严格校验：

management.health.probes.enabled=false

方法2：清理无效配置 #

如果是你主动配置了某个不存在的健康贡献者（比如通过management.health.group.custom.include=xxx指定了一个未实现的贡献者），直接删除这类无效的配置项，也能解决报错问题。

补充提示 #

如果是依赖的自动配置健康贡献者（比如数据库、Redis等）因服务未启动/配置错误导致缺失，除了上述配置，还可以通过management.health.<contributor-name>.enabled=false单独禁用该贡献者的检查（例如management.health.redis.enabled=false）。

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