GKE Kubernetes部署gRPC Python服务频发connection refused错误求助

可能的故障原因及排查方案 #

1. Kubernetes Service配置错误 #

• 确认crud Service与客户端Deployment处于同一命名空间，若跨命名空间需改用完整服务域名：crud.<目标命名空间>.svc.cluster.local:50051
• 检查Service配置：
  • 确认spec.ports.targetPort与Python gRPC服务实际监听的端口一致
  • 若集群启用了Istio等服务网格，需将Service的gRPC端口命名为grpc，否则服务网格会按普通TCP流量转发，导致异常
  • 确认spec.selector与gRPC服务Deployment的labels完全匹配，避免Service后端Endpoint为空

2. gRPC服务监听地址配置错误 #

本地/容器单节点运行时监听127.0.0.1可正常访问，但部署到K8s集群时，必须绑定0.0.0.0才能接受集群内其他Pod的访问，请检查Python gRPC服务启动代码，确认绑定地址为0.0.0.0:50051而非127.0.0.1:50051。

3. 集群网络访问限制 #

• 若集群启用了NetworkPolicy，需配置规则允许客户端Pod访问gRPC服务Pod的50051端口
• 检查GKE VPC防火墙规则，确认集群内部Pod之间的50051端口访问已被放行

4. 代码逻辑优化建议 #

当前代码每次循环都会新建、关闭gRPC连接，频繁建连拆连可能触发集群连接限制或Service转发异常，建议将gRPC连接初始化逻辑移到循环外，复用长连接。另外若无特殊需求，建议移除grpc.WithDisableHealthCheck()配置，避免使用健康检查失败的连接发送请求。

5. gRPC服务Pod状态异常 #

检查gRPC服务Pod是否存在频繁重启、OOM被杀的情况，同时确认livenessProbe/readinessProbe配置正确，避免未完全启动的Pod被加入Service后端承接流量。
可先进入客户端Pod执行连通性测试，排除基础网络问题：

# 测试端口连通性
nc -zv crud 50051

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