nginx-413

Nginx 413 Request Entity Too Large 的定位与修复

现象

上传文件或提交大请求体时返回 413 Request Entity Too Large。Nginx 默认请求体限制通常只有 1 MB。

快速定位

nginx -T | grep -n client_max_body_size
tail -f /var/log/nginx/error.log
curl -v -F 'file=@big.bin' http://127.0.0.1/upload

常见根因

1. client_max_body_size 太小或未配置。
2. 限制配在错误的 server/location 层级。
3. 上游应用、API 网关、WAF 或负载均衡还有更小的限制。
4. 代理缓冲和临时文件配置不足，导致大请求失败。
5. 客户端分块上传或超时，误报为 413。

修复

• 在对应 server 或 location 设置 client_max_body_size，例如 100m。
• 改完 nginx -t 再 reload。
• 检查上游（Tomcat、Spring、API Gateway、ALB）的请求体限制，逐层放宽。
• 大文件上传考虑分片、对象存储直传或流式处理，不要只调大 Nginx。
• 关注 client_body_timeout 和临时目录空间。
• 确认响应头里的 Server，判断 413 是 Nginx 还是上游返回的。

相关命令

• nginx — 配置与日志
• curl — 上传复现
• df — 临时目录空间