Spring Boot Admin同一应用双实例注册异常问题排查

看起来你遇到的是Spring Boot Admin（SBA）中多实例被识别为同一个的典型问题，核心原因大概率是两个实例的instance.id重复了。SBA服务端是通过instance.id来区分不同实例的，如果两个实例的id相同，后注册的会覆盖先注册的，所以你只看到了"MyApp instance 2"。

为什么会出现这个问题？ #

在SBA 2.x版本中，客户端实例的默认id生成规则是：

${spring.application.name}:${spring.cloud.client.hostname}:${spring.application.instance_id}

如果你的两个实例没有显式配置instance.id，且spring.application.instance_id没有被正确设置（比如没启用Spring Cloud或者该属性为空），就会导致两个实例的id完全一致，服务端自然会认为是同一个实例。

解决步骤 #

你只需要给每个实例配置**唯一的instance.id**即可，具体配置方式有两种：

1. 手动指定固定id

给每个实例的application.yml分别配置不同的id：

• 实例1的配置：

spring:
  boot:
    admin:
      client:
        url: http://example.org:7474/admin/
        instance:
          name: 'MyApp instance 1'
          id: 'myapp-instance-1'  # 唯一id
          service-url: http://your-server-ip:your-port-1/  # 对应实例1的服务地址

• 实例2的配置：

spring:
  boot:
    admin:
      client:
        url: http://example.org:7474/admin/
        instance:
          name: 'MyApp instance 2'
          id: 'myapp-instance-2'  # 唯一id
          service-url: http://your-server-ip:your-port-2/  # 对应实例2的服务地址

2. 动态生成唯一id

如果不想手动写死id，可以结合端口号动态生成，这样不同端口的实例自动拥有唯一id：

spring:
  boot:
    admin:
      client:
        url: http://example.org:7474/admin/
        instance:
          name: 'MyApp instance ${server.port}'  # 可选：让名称也带上端口
          id: ${spring.application.name}:${server.port}  # 用应用名+端口作为唯一id
          service-url: http://your-server-ip:${server.port}/

额外检查点 #

• 确认两个实例的server.port确实不同，且服务都正常启动；
• 检查客户端是否正确暴露了端点（SBA需要获取实例信息），确保配置了：

management:
  endpoints:
    web:
      exposure:
        include: "*"

这样配置后，两个实例应该就能在SBA面板中正常显示了。

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