Spring Boot 2.0.0脚手架项目无法暴露自定义Actuator端点

我之前也碰到过几乎一模一样的问题，当自定义Actuator端点作为依赖包引入项目时，经常会因为Spring组件扫描或者Actuator配置的细节问题导致端点不生效。结合你的情况，咱们一步步排查解决：

1. 优先检查组件扫描范围是否覆盖脚手架的端点类 #

这是最常见的触发原因：子项目的Spring扫描路径没包含脚手架里ActiveUsersEndpoint所在的包。

• 如果子项目的启动类用了@SpringBootApplication，可以直接扩展它的扫描路径，把脚手架的包加进去：

  @SpringBootApplication(scanBasePackages = {"com.your.scaffold.package", "com.your.subproject.package"})
  public class SubprojectApplication {
      public static void main(String[] args) {
          SpringApplication.run(SubprojectApplication.class, args);
      }
  }
  

• 更优雅的方式是在脚手架项目里写一个专用配置类，用@ComponentScan指定端点所在的包，这样子项目引入依赖后就能自动扫描到：

  @Configuration
  @ComponentScan(basePackages = "com.your.scaffold.endpoints")
  public class ScaffoldActuatorConfig {
  }
  

2. 确认Actuator的端点暴露配置完整 #

Spring Boot 2.0默认只暴露health和info两个端点，自定义端点必须显式配置才能对外提供服务。确保你的application.yml配置没有遗漏：

management:
  endpoints:
    web:
      base-path: /actuator
      exposure:
        include: "testing-user,health,info" # 明确列出你的端点ID，或者用"*"暴露所有端点
  endpoint:
    testing-user:
      enabled: true # 显式启用该端点，避免默认禁用的情况

3. 验证端点组件是否被Spring容器加载 #

可以借助Actuator自带的beans端点来验证：访问子项目的/actuator/beans，搜索ActiveUsersEndpoint或者testing-user关键词。如果找不到这个组件，说明确实是扫描范围的问题，回到第一步调整路径即可。

4. 核对依赖引入的正确性 #

检查子项目的构建文件（Maven的pom.xml或Gradle的build.gradle），确保脚手架项目的依赖是compile（Maven）或者implementation（Gradle）范围，这样端点类才能被正确加载到子项目的类路径中。

5. 确认注解使用正确 #

务必确保你用的是Spring Boot 2.0官方的@Endpoint注解：org.springframework.boot.actuate.endpoint.annotation.Endpoint，旧版本的Actuator注解在2.0中已被替换，用错注解会导致端点无法被框架识别。

按照上面的步骤排查，应该能快速解决问题——我当时就是因为扫描路径没覆盖到依赖包的端点类，调整后端点就正常暴露了。

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