Kubernetes Service无法与Pod内SpringBoot容器通信问题求助

Let’s tackle this issue step by step—your multi-stage Jenkins pipeline has several moving parts, so we’ll start with the most likely culprits tied to health checks and Kubernetes behavior.

1. 先验证自定义HealthIndicator的正确性 #

Your custom health check is the foundation here—let’s make sure it’s working as expected first:

• 本地启动服务后，直接调用/actuator/health（默认路径，若有修改请对应调整），确认返回状态为UP，且包含你自定义的所有检查项。确保只有当所有必要约束满足时，才返回UP状态。
• 检查application.yml或application.properties中的配置：确认management.endpoints.web.exposure.include=health已开启，management.endpoint.health.show-details设置为always（方便调试查看具体检查项状态）。
• 查看服务启动日志，排查HealthIndicator执行时是否有报错（比如依赖服务未就绪、数据库连接失败等），这类问题会导致服务虽启动但健康状态为DOWN，Kubernetes不会将流量导向该Pod。

2. 修正Kubernetes就绪探针（Readiness Probe）配置 #

This is the most common culprit for your scenario—since your service takes over 3 minutes to be ready, default probe settings will fail prematurely:

• 检查Deployment YAML中的readinessProbe配置，调整参数适配你的启动时长：

  readinessProbe:
    httpGet:
      path: /actuator/health
      port: 8080  # 替换为你的服务端口
    initialDelaySeconds: 200  # 必须大于3分钟（180秒），给足启动时间
    periodSeconds: 10
    failureThreshold: 5  # 适当调大，避免偶发波动导致误判
  

• 同时注意存活探针（Liveness Probe）的配置，initialDelaySeconds也要设置足够长，防止Kubernetes在服务启动完成前就杀掉Pod重启，进入恶性循环。

3. 调整Docker冒烟测试的时机 #

If your Jenkinsfile runs Docker smoke tests immediately after container start, the service won’t be ready yet, causing /health errors:

• 在Jenkinsfile的Docker测试步骤前添加等待逻辑，比如用脚本轮询健康状态直到就绪：

  # 等待服务就绪
  until curl -s http://localhost:8080/actuator/health | grep -q '"status":"UP"'
  do
    echo "Waiting for service to be ready..."
    sleep 10
  done
  # 执行冒烟测试逻辑
  

• 也可以在Dockerfile中添加HEALTHCHECK指令，让Docker自身等待服务就绪：

  HEALTHCHECK --interval=10s --timeout=5s --start-period=180s \
    CMD curl -f http://localhost:8080/actuator/health || exit 1
  

  start-period设置为180秒以上，匹配你的服务启动时长。

4. 验证Kubernetes Service与Pod的连通性 #

If the above steps don’t resolve the issue, let’s rule out network or selector mismatches:

• 先在Pod内部测试：kubectl exec -it <your-pod-name> -- curl http://localhost:8080/actuator/health，确认容器内可正常访问健康路径，排除端口映射或服务启动异常。
• 再从集群内其他Pod测试Service连通性：kubectl run -it --rm debug --image=busybox -- curl http://<service-name>.<namespace>.svc.cluster.local/actuator/health，排查Service的Selector是否与Pod Labels匹配，或是否有网络策略阻止流量。
• 查看Pod事件日志：kubectl describe pod <your-pod-name>，检查Events中是否有探针失败、网络错误等提示信息。

5. 优化Jenkinsfile的部署后等待逻辑 #

Make sure your pipeline doesn’t run Service smoke tests immediately after deploying the Deployment—wait for Pods to be ready first:

• 在Jenkinsfile的Kubernetes部署步骤后，添加等待Pod就绪的命令：

  sh 'kubectl wait --for=condition=ready pod -l app=<your-app-label> --timeout=300s'
  

  等待Pod进入就绪状态后，再执行Service的冒烟测试，避免因测试时机过早导致失败。

内容的提问来源于stack exchange，提问作者David M. Karr