Spring Boot Admin集成Eureka启动报错：无法获取实例状态

环境配置：

• Spring Boot 3.2.1
• Spring Boot Admin (SBA) 3.2.1
• 服务发现基于Eureka Server

启动SBA时控制台报错：

"Couldn't retrieve status for Instance(id=32f1b3fba304, version=0, registration=Registration(name=GATEWAY, managementUrl=http://host:port/actuator, healthUrl=http://host:port/actuator/health, serviceUrl=http://host:port, source=discovery), registered=true, statusInfo=StatusInfo(status=UNKNOWN, details={}), statusTimestamp=2024-05-14T10:50:43.446449Z, info=Info(values={}), endpoints=Endpoints(endpoints={health=Endpoint(id=health, url=http://host:port/actuator/health)}), buildVersion=null, tags=Tags(values={}))"

现象：

• Eureka控制台显示该GATEWAY实例状态为UP
• SBA中该实例状态显示为UNKNOWN
• 已确认注册信息中的managementUrl、healthUrl等均可正常访问

可能原因 #

1. 跨域资源共享(CORS)限制：GATEWAY服务的Actuator端点未配置允许SBA所在域名的跨域请求，导致SBA无法正常获取健康状态。
2. Actuator端点权限配置问题：GATEWAY的Actuator健康端点被安全拦截（比如Spring Security），SBA请求时未携带正确的认证信息，导致请求失败。
3. SBA的Eureka实例元数据解析问题：SBA从Eureka获取实例信息时，未正确识别或使用实例的健康检查端点元数据，导致无法发起有效请求。
4. 健康检查端点响应格式不兼容：GATEWAY的健康端点返回的响应格式不符合SBA的预期（比如缺少必要的status字段），导致SBA无法解析状态。

修复方案 #

1. 配置Actuator跨域允许 #

在GATEWAY服务的application.yml或application.properties中添加CORS配置：

management:
  endpoints:
    web:
      cors:
        allowed-origins: "http://your-sba-host:your-sba-port" # 替换为SBA的实际地址
        allowed-methods: "GET,POST"

2. 调整Actuator安全权限配置 #

如果使用Spring Security，需要确保健康端点允许匿名访问，或者配置SBA的认证信息：

@Configuration
public class SecurityConfig {
    @Bean
    public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
        http.authorizeHttpRequests(auth -> auth
                .requestMatchers("/actuator/**").permitAll() // 允许所有Actuator端点匿名访问
                .anyRequest().authenticated()
        );
        return http.build();
    }
}

或者在配置文件中简化配置（仅建议测试环境使用）：

management:
  security:
    enabled: false

3. 配置SBA正确识别Eureka实例元数据 #

在SBA服务的配置文件中，确保开启Eureka发现支持，并配置正确的实例信息解析规则：

spring:
  cloud:
    discovery:
      client:
        enabled: true
  boot:
    admin:
      discovery:
        enabled: true
        service-name: GATEWAY # 指定要监控的服务名，留空则监控所有实例

4. 检查健康端点响应 #

访问GATEWAY的http://host:port/actuator/health，确认返回的JSON包含正确的status字段，示例正常响应：

{
  "status": "UP",
  "components": {
    "diskSpace": {
      "status": "UP",
      "details": {
        "total": 107374182400,
        "free": 53687091200,
        "threshold": 10485760
      }
    }
  }
}

如果响应异常，检查GATEWAY的健康指示器配置，排查是否有自定义指示器导致状态解析失败。

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