如何配置Spring-Boot-Admin选择正确的actuator端口

当应用分离业务端口与Actuator管理端口时，Spring Boot Admin（以下简称SBA）默认读取业务端口导致功能异常，本质是客户端向SBA注册时未正确上报管理端点地址，按以下步骤配置即可修复：

1. 被监控业务应用（SBA客户端）配置 #

1.1 确认Actuator独立端口基础配置 #

首先确保管理端点配置正确，示例配置如下：

# 业务请求端口
server:
  port: 8080

# Actuator独立管理端口配置
management:
  server:
    port: 8081 # 替换为实际使用的Actuator端口
  endpoints:
    web:
      exposure:
        include: "health,info,metrics,env" # 按需开放端点，至少开放health、info等SBA必需端点

1.2 显式指定注册到SBA的管理地址 #

默认配置下SBA客户端会自动上报业务端口作为服务地址，需手动指定管理端点的访问地址，这是核心配置：

spring:
  boot:
    admin:
      client:
        url: http://SBA服务端IP:SBA端口 # 替换为实际SBA服务端地址
        instance:
          # 显式指定Actuator端点的根地址
          management-base-url: http://当前应用IP:${management.server.port}
          # 可选：显式指定健康检查地址，避免SBA从业务端口探活
          health-url: ${spring.boot.admin.client.instance.management-base-url}/actuator/health

1.3 基于注册中心发现实例的特殊配置 #

如果你的应用是通过Nacos/Eureka等注册中心被SBA发现，不需要配置上面的直连地址，只需在注册中心的实例元数据中写入管理端口即可，以Eureka为例：

eureka:
  instance:
    metadata-map:
      management.port: ${management.server.port}
      management.address: 当前应用IP

Nacos配置逻辑一致，在实例元数据中添加management.port字段，SBA会自动读取元数据中的端口信息拼接Actuator地址。

2. SBA服务端兜底配置（不推荐优先使用） #

如果客户端无法修改配置，可在SBA服务端配置全局端口映射规则，强制将指定实例的Actuator请求转发到管理端口：

spring:
  boot:
    admin:
      instance:
        # 按实际规则替换地址，示例为将所有实例的管理端口统一设为业务端口+1
        management-base-url: http://${service.host}:${service.port+1}

验证方式：配置完成后重启对应服务，进入SBA控制台的实例详情页，查看Endpoints列表下的所有接口地址，确认端口为你配置的Actuator端口即为生效。如果仍异常，优先检查配置是否被配置中心覆盖、管理端口是否有网络访问限制。

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