Spring Boot测试中自定义Actuator端点依赖HealthEndpoint找不到问题排查

问题核心原因 #

测试环境下org.springframework.boot.actuate.health.HealthEndpoint对应的Bean没有被Spring自动注册，基本是配置加载优先级、多Profile配置冲突导致的，具体排查解决步骤如下：

解决方案 #

• 第一步：强制测试环境启用HealthEndpoint

直接在@SpringBootTest注解中显式传入配置，优先级高于所有yaml配置，避免被高优先级配置覆盖，90%以上的同类问题做完这步即可解决：

@SpringBootTest(classes = Application.class, webEnvironment = RANDOM_PORT, properties = {
    "management.endpoint.health.enabled=true",
    "management.endpoints.enabled-by-default=true"
})
@ActiveProfiles(profiles = {"test1", "test2"})
public class TheFailingIT {
}

• 第二步：排查多Profile配置冲突

你在测试中激活了test1、test2两个Profile，Spring Boot中激活Profile对应的配置文件（application-test1.yaml、application-test2.yaml）优先级高于默认的application.yaml，检查这两个文件中是否存在management.endpoint.health.enabled=false的配置，覆盖了你的默认配置。

• 第三步：确认Actuator依赖范围正确

检查你的依赖配置（pom.xml或build.gradle）中spring-boot-starter-actuator依赖没有被设置为仅生产环境可用，比如不要出现<scope>provided</scope>、<optional>true</optional>这类限制测试环境加载的配置。

• 兜底方案：手动注册HealthEndpoint Bean

如果以上步骤都排查后问题仍存在，可以新增配置类手动注册Bean，跳过自动配置的逻辑：

@Configuration
public class ActuatorConfig {
    @Bean
    public HealthEndpoint healthEndpoint(HealthContributorRegistry registry, HealthEndpointGroups groups) {
        return new HealthEndpoint(registry, groups);
    }
}

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