Kubernetes部署Spring Boot微服务出现Eureka注册连接被拒问题

报错本质是user-auth服务容器内将Eureka Server地址解析为localhost:8761，Kubernetes为每个Pod分配独立网络命名空间，localhost仅指向当前Pod自身，既不是宿主机地址也不是Eureka服务地址，连接必然被拒绝。给defaultZone配置值追加末尾斜杠仅能解决Eureka客户端路径拼接异常问题，无法解决当前网络层寻址错误。

1. 替换defaultZone为K8s集群内可解析的Eureka服务地址 #

首先确认Eureka Server已经在集群中创建了对应Service资源，将eureka.client.service-url.defaultZone配置改为K8s内部DNS地址：

eureka:
  client:
    service-url:
      # K8s服务DNS规则：<服务名>.<命名空间>.svc.cluster.local:<服务端口>/eureka
      # 同命名空间下可省略后缀，直接写http://<eureka服务名>:8761/eureka/
      defaultZone: http://eureka-server.default.svc.cluster.local:8761/eureka/

禁止使用localhost、节点物理IP作为注册中心地址：前者指向Pod自身无法跨容器访问，后者会因为节点漂移、端口映射规则变动导致注册/心跳异常。

2. 确认配置实际生效 #

配置修改后不生效是这类问题的高频诱因，按以下步骤校验：

• 进入user-auth服务Pod检查配置文件实际内容：

  kubectl exec -it <user-auth的Pod名称> -- cat <配置文件在容器内的绝对路径>
  

  确认文件内defaultZone值为上述修改后的K8s DNS地址，不存在localhost配置。
• 检查Pod启动日志中的激活profile信息，确认应用加载的是你修改的对应环境配置文件，避免出现修改了prod环境配置但启动时未指定spring.profiles.active=prod、默认加载application.yml中旧配置的问题。

3. 校验Eureka服务连通性 #

如果配置确认正确仍报连接错误，直接在user-auth Pod内测试Eureka地址可达性：

kubectl exec -it <user-auth的Pod名称> -- sh
# 容器内无curl可替换为wget
curl http://eureka-server.default.svc.cluster.local:8761/eureka/

连通失败时按顺序排查：

• 检查Eureka对应的Service配置：确认selector标签和Eureka Pod标签完全匹配，Service端口映射的targetPort和Eureka Server实际监听端口一致（默认8761）
• 检查Eureka Pod运行状态：确认Pod处于Running状态，就绪探针未失败
• 检查集群网络策略：确认不存在NetworkPolicy规则拦截user-auth服务到Eureka服务8761端口的流量

4. 补充配置（解决注册成功后服务间调用失败问题） #

服务注册成功后如果出现微服务间调用异常，追加以下配置让Eureka实例注册Pod IP而非内部hostname：

eureka:
  instance:
    prefer-ip-address: true

重新部署服务后查看Pod日志，出现DiscoveryClient - USER-AUTH - registration status: 204字样即为心跳正常，也可直接访问Eureka控制台查看已注册实例列表确认USER-AUTH服务存在。

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