Kubernetes中Spring Boot Admin微服务注册后离线问题排查

问题根源 #

报错显示Admin Server无法解析微服务Pod的名称my-service-deploy-58df8554f9-9g4k4，核心原因是Kubernetes集群默认DNS仅支持解析Service名称，普通Deployment的Pod名称不会被DNS直接解析。Spring Boot Admin客户端默认会将Pod的主机名（即Pod名称）注册给Admin Server，导致Admin Server尝试通过Pod名称访问时出现DNS解析失败。

解决步骤 #

方案1：配置客户端注册Service地址（推荐） #

修改微服务的配置，指定注册到Admin Server的实例地址为自身的Service地址，让Admin Server通过稳定的Service访问微服务的管理端点：

spring:
  boot:
    admin:
      client:
        url: http://myadmin-service-svc:8080
        instance:
          service-base-url: http://my-service-svc:8080  # 替换为你的微服务Service名称

注：my-service-svc是微服务对应的Kubernetes Service名称，确保该Service已正确暴露微服务的管理端口（默认是8080，若修改过需对应调整）。

方案2：检查管理端点监听地址 #

确认微服务的management.server.address未设置为localhost，否则Admin Server无法从集群内部访问管理端点：

management:
  server:
    address: 0.0.0.0  # 允许所有地址访问管理端点

方案3：使用Headless Service（可选，不推荐） #

如果需要直接访问Pod，可为微服务创建Headless Service，此时Pod的FQDN（pod-name.service-name.namespace.svc.cluster.local）可被DNS解析：

apiVersion: v1
kind: Service
metadata:
  name: my-service-headless
spec:
  clusterIP: None  # 标记为Headless Service
  selector:
    app: my-service  # 替换为你的微服务Pod标签
  ports:
  - port: 8080
    targetPort: 8080

同时修改微服务配置，让客户端注册FQDN：

spring:
  boot:
    admin:
      client:
        instance:
          hostname: ${HOSTNAME}.my-service-headless.your-namespace.svc.cluster.local

注：该方案仅适用于需要直接访问Pod的场景，Pod重启后名称会变化，稳定性不如方案1。

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