K8s部署Nginx上传超500MB文件时出现502 Bad Gateway错误求助

1. 确认Nginx Ingress Controller配置是否生效 #

你添加的注解需要确保被Ingress Controller正确加载：

• 进入Nginx Ingress Controller的Pod：

  kubectl exec -it <nginx-ingress-controller-pod-name> -n <namespace> -- /bin/sh
  

• 查看生成的nginx配置文件（通常路径为/etc/nginx/nginx.conf或/etc/nginx/conf.d/下的Ingress相关配置），搜索client_max_body_size，确认值为1500m。
  若配置未生效，检查：
  • Ingress资源是否正确应用：执行kubectl apply -f ingress.yaml后无报错，用kubectl describe ingress <ingress-name>确认注解已存在。
  • Nginx Ingress Controller版本兼容性：部分旧版本可能对部分注解支持不完善。

2. 检查Node.js应用的文件上传限制 #

Node.js应用自身可能存在文件大小限制：

• 若使用Express框架：
  • 用multer处理上传时，检查limits配置：

    const multer = require('multer');
    const upload = multer({
      limits: {
        fileSize: 1500 * 1024 * 1024 // 1500MB，需与Ingress配置一致
      }
    });
    

  • 用body-parser处理JSON/urlencoded请求时，检查limit参数：

    app.use(bodyParser.json({ limit: '1500mb' }));
    app.use(bodyParser.urlencoded({ limit: '1500mb', extended: true }));
    

• 若使用其他框架，对应检查框架的文件上传大小限制配置。

3. 排查集群外部/中间层负载均衡限制 #

如果集群前端有额外负载均衡器（云厂商ALB/NLB、硬件负载均衡等），这类设备通常有默认请求体大小限制：

• 比如部分云厂商LB默认限制为500MB，需登录控制台修改对应负载均衡的请求大小上限。
• 若Ingress前还有其他API网关或反向代理，同步检查它们的请求体大小限制配置。

4. 调整Nginx Ingress的缓冲相关配置 #

当前你配置了缓冲参数，可尝试关闭请求缓冲（更适配大文件上传场景）：
在Ingress注解中添加：

nginx.ingress.kubernetes.io/proxy-request-buffering: "off"

开启缓冲时，Nginx会先将整个请求体缓冲到内存或磁盘，大文件可能因磁盘空间不足、超时等问题触发502，关闭后会直接转发请求到后端Pod。

5. 检查Pod与节点的资源状态 #

虽然已提升Pod资源配额，仍需确认：

• Pod是否出现OOMKilled事件：执行kubectl describe pod <pod-name>查看Events，若存在OOM，说明内存配额仍不足，需继续调整。
• 节点磁盘空间：大文件上传时，Pod临时存储（如multer默认临时目录）会占用节点磁盘，若磁盘不足会导致上传失败，用kubectl top node或登录节点查看磁盘使用情况。

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