Nginx反向代理需协同配置client_max_body_size、超时与缓冲参数，并同步放宽后端限制，否则易出现413、502/504错误或后端拒收；推荐Nginx限值略大于后端（如后端80MB，Nginx设100MB），并关闭proxy_buffering以支持流式上传。
在 Nginx 作为反向代理使用时，限制请求体大小不能只靠单个配置——必须同时控制 Nginx 自身的接收能力、与后端通信的行为、以及后端服务的实际承载上限。否则容易出现“Nginx 放行了，后端却拒收”或“上传卡住返回 502/504”的情况。
核心：client_max_body_size 必须显式设置
这是第一道闸门，决定 Nginx 是否允许请求体进入：
- 它默认为 1m（1MB），超限直接返回 413 Request Entity Too Large
- 单位支持 k / m / g（注意小写，
20M会报错，20m才合法） - 推荐按路径精细设置，例如：
location /upload {<br> client_max_body_size 100m;<br>} - 若所有接口统一策略，可在
server块中设，比放在http块更稳妥（避免被未覆盖的 location 继承默认 1m）
代理场景下必须同步调整的配套参数
大 body 在代理链路中容易因缓冲、超时或转发机制中断：
-
延长读取超时：防止上传中途断连
client_body_timeout 120s;（默认 60s，大文件建议翻倍） -
调高缓冲区：减少磁盘临时文件写入，提升稳定性
client_body_buffer_size 128k;（默认通常 8k–16k，上传路径可适当提高） -
关闭代理缓冲（关键）：避免 Nginx 把整个 body 缓存后再发给后端，造成内存压力或延迟
proxy_buffering off;和proxy_request_buffering off;（Nginx ≥1.13.10） -
匹配后端超时：确保与后端交互不超时
proxy_read_timeout 180s;<br>proxy_send_timeout 180s;
别忘了后端服务也得放开限制
Nginx 只是网关，不是终点。即使它全放行，后端仍可能拦截：
-
Spring Boot：设置
spring.servlet.multipart.max-file-size=128MB和spring.servlet.multipart.max-request-size=128MB -
Node.js（Express + Multer）：
multer({ limits: { fileSize: 100 * 1024 * 1024 } }) -
PHP：检查
upload_max_filesize和post_max_size（需 ≥ Nginx 设置） - 建议 Nginx 限制略大于后端，留出 10–20% 缓冲余量（如后端设 80MB，Nginx 设 100MB）
验证是否真正生效
光改配置不测试，等于没改：
- 用 curl 模拟边界值：
curl -X POST --data-binary @test_99m.zip http://your-domain/upload - 检查 Nginx 错误日志：
tail -f /var/log/nginx/error.log，搜索client intended to send too large body或413 - 确认配置已加载：
nginx -t && nginx -s reload - 注意 CDN 或 WAF 层也可能有独立限制，需一并排查
