client_max_body_size必须在location块中显式配置才真正生效，否则即使server或http块已设置仍可能返回413错误；还需同步调整client_body_buffer_size、client_body_temp_path权限、proxy_read_timeout等参数，并校验后端及请求头限制。
在 Nginx 配置中设置客户端请求体大小上限，核心是 client_max_body_size 指令，但必须放在匹配上传路径的 location 块内 才真正生效——只写在 http 或 server 块里，90% 的情况下仍会返回 413 错误。
必须写在 location 块中
Nginx 按“就近匹配”原则应用配置，client_max_body_size 不自动继承父级。比如你访问的是 /api/upload，而该路径对应的 location 块里没写这行，Nginx 就用默认值 1M，哪怕 server 块里写了 100M 也无效。
- ✅ 正确示例（针对上传接口）：
location /api/upload {
client_max_body_size 500m;
proxy_pass http://backend;
} - ⚠️ 不推荐仅在 server 块设：整个站点所有 POST 请求（含登录、表单）都会放宽，扩大攻击面
- ❌ 典型错误：在 http 块末尾加了
client_max_body_size 100m，但上传路径的 location 没重写，实际仍走 1M
配套参数必须同步调整
client_max_body_size 只控制“是否放行”，不保证“传得稳”。大文件上传还依赖缓冲、临时文件、超时和请求头等环节：
-
client_body_buffer_size：建议设为
512k～1m。太小（如默认 8k）会导致频繁刷盘；太大浪费内存 -
client_body_temp_path：确认路径（如
/var/tmp/nginx/body）存在，且 Nginx 运行用户（如www-data）有读写权限，否则日志报Permission denied -
proxy_read_timeout 和 proxy_send_timeout：建议设为
3600（1 小时），避免 Nginx 在收全 body 前就断连
别漏掉请求头大小限制
POST 请求若带长 JWT、多层代理头或超大 Cookie，可能在解析 header 阶段就失败，返回 400 或静默断连，根本不会走到 body 校验：
- 检查 error.log 是否有
client sent too large request或request header or cookie too large - client_header_buffer_size 默认 1k，不够时启用 large_client_header_buffers（默认 4 个 8k buffer，共 32KB）
- 临时调试可设
large_client_header_buffers 8 16k;，但长期不宜过大，防内存压力
验证与生效步骤
改完配置不能直接生效，必须：
- 运行
nginx -t检查语法是否正确 - 执行
nginx -s reload或systemctl reload nginx重新加载 - 用真实请求测试：
curl -F "file=@large.zip" http://yourhost/api/upload - 查看
/var/log/nginx/error.log：出现client intended to send too large body表示限制已起效
