Spring Boot启动报错：需配置org.springframework.boot.actuate.health.HealthEndpoint类型Bean

报错信息 #

***************************
APPLICATION FAILED TO START
***************************

Description:

Parameter 0 of constructor in HiddenClass required a bean of type 'org.springframework.boot.actuate.health.HealthEndpoint' that could not be found.


Action:

Consider defining a bean of type 'org.springframework.boot.actuate.health.HealthEndpoint' in your configuration.

解决步骤 #

1. 确认Actuator依赖已引入 #

Spring Boot Actuator是提供HealthEndpoint的基础模块，先检查项目依赖是否包含它：

• Maven项目（pom.xml）：

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

• Gradle项目（build.gradle）：

implementation 'org.springframework.boot:spring-boot-starter-actuator'

注意依赖版本要和你的Spring Boot版本保持一致。

2. 配置暴露Health端点 #

Actuator默认不会暴露所有端点，需在配置文件中开启Health端点的Web访问：

• application.properties：

# 暴露health端点
management.endpoints.web.exposure.include=health
# 可选：显示完整健康详情（默认只显示状态）
management.endpoint.health.show-details=always

• application.yml：

management:
  endpoints:
    web:
      exposure:
        include: health
  endpoint:
    health:
      show-details: always

3. 手动注册HealthEndpoint Bean（如果上述步骤无效） #

如果依赖和配置都没问题，但依然找不到Bean，可以手动在配置类中定义：

import org.springframework.boot.actuate.health.HealthEndpoint;
import org.springframework.boot.actuate.health.HealthIndicator;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class ActuatorConfig {
    @Bean
    public HealthEndpoint healthEndpoint(HealthIndicator healthIndicator) {
        return new HealthEndpoint(healthIndicator);
    }
}

4. 检查HiddenClass的组件扫描状态 #

确保HiddenClass所在的包被Spring Boot的组件扫描覆盖：

• 启动类上的@SpringBootApplication默认扫描自身所在包及子包，若HiddenClass在外部包，需添加@ComponentScan(basePackages = "com.your.package")指定扫描路径。
• 确认HiddenClass上标注了@Component、@Service或其他Spring组件注解，让容器能识别并管理它。

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