nginx 处理超大型请求体需分级配置 client_max_body_size、合理设置 client_body_buffer_size、关闭 proxy_request_buffering 和 proxy_buffering，并同步校准权限、超时及后端限制。
要让 Nginx 稳定处理超大型请求体（比如几百 MB 的文件上传、巨量 JSON 或分片报文），关键不是堆大内存，而是让缓冲策略匹配真实流量特征、并发模型和系统资源。配置错一个环节，就可能触发 413、500、502 或静默失败——而日志里往往只显示模糊提示。
按业务路径分级设置 client_max_body_size
这个值必须显式写在 location 块中，否则不生效。Nginx 不继承父级配置，只认当前匹配块的设置：
- 上传专用路径（如
/upload、/api/v1/files）设为具体值，例如client_max_body_size 20G; - 纯 API 接口（如
/api/）保持保守，设2m～10m，防恶意放大攻击 - 禁用检查仅用于调试：
client_max_body_size 0;，生产环境不建议开启
精准匹配分片或单次上传大小设 client_body_buffer_size
它决定请求体是否全程走内存。设小了会频繁落盘；设大了则高并发时吃光内存。记住 Nginx 内部有 25% 安全扩容机制：
- 若单个分片最大 6MB，不要设
6m，而应设7680k或8m，确保 ≤6MB 请求能完整驻留内存 - 后台批量上传接口（≤20MB）可设
2m～4m，但需配合limit_conn控制并发数 - 轻量 API 接口保持默认
16k或压到8k，省下的内存可用于更多连接
强制流式透传，避免整体会话缓存
超大请求体最怕 Nginx 先收全再发——这既耗内存又拖延迟。必须关闭两层默认缓冲：
-
proxy_request_buffering off;（Nginx ≥1.13.10 必须显式关闭） -
proxy_buffering off;（防止响应也被缓存，实现端到端直通） -
client_body_in_file_only clean;作为兜底（临时文件用完即删），但仅在内存敏感场景启用
同步校准权限、超时与后端限制
只调 Nginx 没用，整个链路必须对齐：
- 确认
client_body_temp_path目录属主正确、有w+x权限；连带检查proxy_temp、fastcgi_temp等目录 - 延长关键超时：
client_body_timeout 3600;、proxy_read_timeout 3600;、proxy_send_timeout 3600; - 后端限制（如 Spring Boot 的
spring.servlet.multipart.max-file-size）应略小于 Nginx 设置，留出解析余量
