升级Nginx Ingress Controller后大文件上传出现502 Bad Gateway问题

我之前碰到过几乎一模一样的情况！升级Ingress Controller从0.8.2到0.11.0后，10MB以上的大文件上传直接报502，小文件却完全正常，而且明明已经在ConfigMap里把proxy-body-size设成了500m，配置也确认生效了。日志里那个000 0的状态码其实是关键线索——它表示连接在服务器返回响应之前就被中断了。

问题根源 #

0.11.0版本的Nginx Ingress Controller相比0.8.2，默认的超时参数更严格，而且缓冲机制有调整。大文件上传需要更长的传输时间，默认的超时时间（通常是60秒）不足以完成上传，导致Nginx提前断开与后端的连接，返回502错误。

解决方案 #

你需要在Ingress的ConfigMap里添加/调整几个超时相关的参数，同时保留已有的proxy-body-size设置：

1. 创建或修改你的Nginx Ingress ConfigMap：

apiVersion: v1
kind: ConfigMap
metadata:
  name: nginx-ingress-controller
  namespace: kube-system # 这里根据你的Ingress部署namespace调整
data:
  proxy-body-size: "500m"
  proxy-read-timeout: "300"       # 延长后端响应读取超时，单位秒
  proxy-send-timeout: "300"       # 延长后端响应发送超时，单位秒
  client-body-timeout: "300"      # 延长客户端发送请求体的超时，单位秒
  client-header-timeout: "60"     # 可选，保持默认或适当延长

2. 重启Ingress Controller Pod让配置生效：

kubectl rollout restart deployment nginx-ingress-controller -n kube-system

额外排查点 #

如果调整超时后还是有问题，可以尝试关闭请求缓冲（不建议默认关闭，除非你的后端服务支持流式上传），在ConfigMap里添加：

proxy-request-buffering: "off"

这会让Nginx直接把请求体转发给后端，而不是先缓冲到本地，避免大文件缓冲时出现的异常。

验证 #

调整完成后，再测试10MB以上的文件上传，应该就能成功了。同时检查日志，会看到正常的200状态码，而不是之前的000 0。

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