SpringBoot Admin 3.2.1无法正确显示ECS上客户端应用状态

• 检查网络连通性

  • 在ECS客户端容器内执行curl <SpringBoot Admin的URL>/actuator，确认能正常访问Admin服务的端点。Fargate的安全组可能限制了客户端到Admin的出站流量，或者Admin的安全组没开放客户端的入站端口，这时候要调整安全组规则。
  • 同时确认Admin服务能访问客户端的actuator端点：客户端容器的安全组要允许Admin服务的IP段访问management.server.port（默认8080，改了的话对应调整），或者显式配置spring.boot.admin.client.instance.service-url为客户端对外可访问的地址（比如负载均衡域名+端口），避免Admin无法识别Fargate容器的内部IP。

• 补全客户端关键配置

  • 当前配置缺少必要的端点暴露和健康详情设置，补充以下内容：

    # 暴露所有监控端点（至少包含health,info,metrics）
    management.endpoints.web.exposure.include=*
    # 显示健康详情，让Admin能正确判定状态
    management.endpoint.health.show-details=always
    # 指定客户端对外可访问的基础URL，Admin会用这个地址拉取监控数据
    spring.boot.admin.client.instance.base-url=http://<客户端外部访问地址>
    

  • 核对spring.boot.admin.client.url是否为Admin服务的正确外部URL，注意是否带端口（默认8080，Admin改了端口必须加上），有没有拼写错误。

• 验证依赖版本匹配

  • 确认客户端Spring Boot版本和Admin 3.2.1对应：Admin 3.2.x适配Spring Boot 3.2.x，版本不匹配会导致注册或状态同步失败。
  • 检查pom.xml中的Admin客户端依赖是否正确：

    <dependency>
        <groupId>de.codecentric</groupId>
        <artifactId>spring-boot-admin-starter-client</artifactId>
        <version>3.2.1</version>
    </dependency>
    

• 查看日志定位问题

  • 搜客户端应用日志里的SpringBootAdminClient相关内容，看有没有注册失败、心跳发送超时、404这类报错。
  • 搜Admin服务日志里的客户端实例名「App」，看是否有接收注册请求但处理失败，或者无法访问客户端端点的记录。

• Fargate任务配置检查

  • 确认任务定义里的环境变量（如果用它覆盖application.properties）是否正确，避免配置值没生效。
  • 如果客户端改了management.server.port，要在任务定义里暴露对应端口，同时安全组允许该端口的入站流量。

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