K8s中轮询失效本质是流量链路多环节叠加问题，需区分Nginx是否真未轮询或仅不可见；核心排查点包括Ingress Controller轮询策略配置、Service Endpoints实际Pod数、后端应用连接复用及注解校验强制化导致配置加载失败。
轮询失效在K8s中不是Nginx配置写错了，而是整个流量链路中多个环节叠加导致的表象问题。核心要分清：是Nginx本身没轮询，还是轮询了但你看不到、测不出、用不上。
确认是否真失效：先看日志和真实请求分发
很多所谓“轮询不生效”，其实是没验证对地方。Nginx的upstream轮询只作用于它直接代理的后端服务——在K8s里，这个“后端”通常是Service的ClusterIP或Endpoint，而不是Pod IP。
- 进Nginx容器，查access日志：
tail -f /var/log/nginx/access.log，观察upstream_addr字段是否在多个后端地址间跳变 - 若用Ingress Controller（如nginx-ingress），日志默认不打upstream_addr，需在ConfigMap中开启：
enable-access-log-for-default-backend: "true"并加log-format-upstream: '$remote_addr - $remote_user [$time_local] "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent" $request_time $upstream_response_time $upstream_addr' - 避免用
curl localhost测试：它绕过DNS和服务发现，可能始终命中同一Pod；应从集群外或另一个Pod内发起请求
常见真失效原因与对应修复
K8s环境下的轮询失效，90%集中在三个位置：Ingress Controller配置、Service对象行为、后端Pod就绪态管理。
-
Ingress Controller未启用轮询策略：默认使用
least_conn（最少连接）而非轮询。需在Ingress资源中显式指定注解：nginx.ingress.kubernetes.io/upstream-hash-by: ""（清空哈希键），或通过ConfigMap全局设upstream-hash-by: "" -
Service类型为ClusterIP + 默认sessionAffinity=none时仍不轮询：检查Endpoints是否真实包含多个Pod IP：
kubectl get endpoints <service-name></service-name>；若只显示1个地址，说明Pod未就绪（readinessProbe失败、Pending状态、节点污点排斥等） -
后端应用自身有长连接或连接池复用：比如Java应用用HttpClient保持连接，单次建立后反复复用，导致Nginx看似只发给一个Pod。可在Nginx侧强制关闭连接：
proxy_http_version 1.1; proxy_set_header Connection ''; proxy_set_header Proxy-Connection '';
云原生场景下更可靠的替代方案
硬调Nginx轮询在K8s里属于“逆生态操作”。K8s原生的服务发现和负载均衡机制，本就不依赖Nginx做第一层分发。
- 用
Service的externalTrafficPolicy: Cluster（默认）+ 多副本Deployment，让kube-proxy的iptables/ipvs规则完成天然轮询，Nginx仅作反向代理，不参与负载逻辑 - 若必须用Ingress做灰度或路由，改用
weight注解实现加权轮询，比纯轮询更可控：nginx.ingress.kubernetes.io/upstream-weight: "5"（配合其他Pod设为3/2） - 高可用要求强的生产环境，建议把Nginx Ingress Controller本身部署为多副本，并用
type: LoadBalancer暴露——由云厂商SLB做最外层轮询，K8s内Ingress副本再各自轮询后端，形成双保险
升级带来的隐性破坏：注解校验强制化
从Ingress-NGINX v1.12起，默认开启注解强校验。一个拼错的rewrite-target或格式错误的正则，会导致整个Ingress配置加载失败，表现为“轮询没动静”——其实Nginx压根没加载该路由规则。
- 立刻查控制器日志：
kubectl logs -n ingress-nginx deploy/ingress-nginx-controller --tail=50 | grep -i "validation\|invalid" - 临时恢复可用性：编辑Deployment，添加启动参数
--enable-annotation-validation=false（仅限紧急回退） - 长期解法：统一用
helm upgrade更新Chart，并校验values.yaml中所有注解是否符合v1.12+规范，尤其注意regex类字段需转义
