client_max_body_size仅控制Nginx是否允许请求体进入，设小则直接返回413，设对才进入后续流程；大宗商品图建议按P95真实流量设32m（非32M），须置于server块、同步调优client_body_timeout、后端限制及client_body_temp_path权限与空间。
client_max_body_size 本身不负责“顺畅上传”，它只是一道守门员——值设小了，大图直接被拦在 Nginx 门外，返回 413 Request Entity Too Large；设对了，上传才能进入后续流程。大宗商品图（如高清质检图、仓储全景图、设备特写图）常达 5–50MB，HTTPS 加密下传输本就更耗时，若再因配置卡住，用户点击上传后秒报错，体验彻底中断。
所以，调优目标很明确：让典型商品图能顺利通过 Nginx 这一关，不被提前拒绝，为后续代理转发、后端处理和 HTTPS 稳定传输留出空间。
先确认你真正要传多大的图
别凭感觉写 100M。
大宗商品图有明显特征：
- 普通质检截图/单设备照片：2–8 MB
- 全景扫描图（如仓库俯拍）、带标注的 PDF 图文包：10–30 MB
- 少数高精度工业相机输出（未压缩 TIFF/RAW）：可能超 50 MB，但这类应走专用协议，不走常规 HTTPS 表单
建议用 Nginx access log 记录 $request_length，或临时加日志：
log_format upload_log '$remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'req_len:$request_length';
access_log /var/log/nginx/upload.log upload_log;跑 3–5 天真实上传流量，取 P95 值（覆盖 95% 的请求），这就是你该设的底线。
在 server 块中设置，别全局乱改
把配置写在具体服务的 server { } 块里，例如：
server {
listen 443 ssl;
server_name upload.goods-platform.com;
client_max_body_size 32m; # 覆盖绝大多数商品图
client_body_timeout 600s; # HTTPS 下大图上传慢，给足时间
...
}这样既不影响其他域名（比如管理后台、API 接口），又避免 http { } 全局设置带来的安全冗余。
注意单位：32m = 32 MiB（不是 MB），Nginx 默认按二进制单位解析，更准确。不要写 32M 或 32MB。
必须同步检查三个配套项
光调 client_max_body_size 是单点突破，极易失效：
后端服务也要放开限制
如果你用 Node.js + Express，需设app.use(express.json({ limit: '32mb' }))和app.use(express.urlencoded({ limit: '32mb', extended: true }))；
PHP 则要同步改php.ini中的post_max_size和upload_max_filesize，且二者 ≥ Nginx 的值。HTTPS 不影响 body 大小判断，但会影响超时
TLS 握手+加密传输会增加首字节延迟，尤其弱网环境下。所以client_body_timeout必须延长（推荐 300–600 秒），否则未传完就断连，Nginx 日志里会出现client timed out。-
确保磁盘临时路径可用（防 fallback 失败）
即使设了32m，万一某张图超限（比如 35MB），Nginx 仍会走client_body_temp_path落盘。这个路径默认是/var/temp/client_body，务必：- 目录存在且 Nginx worker 用户（如
www-data）有写权限 - 所在分区剩余空间 ≥ 单次最大上传 × 并发数（例如支持 10 人并发传 32MB，预留 400MB 以上）
- 更优做法：挂载
tmpfs到内存盘，例如：mount -t tmpfs -o size=2g tmpfs /var/temp/client_body
- 目录存在且 Nginx worker 用户（如
验证是否真起作用
别只 nginx -t && nginx -s reload 就算完：
- 上传一张 刚好略小于设定值 的图（如设 32m，传 31.5MB），看是否成功返回 200
- 上传一张 略超设定值 的图（如 32.1MB），确认返回标准 413 页面（而非 502/504）
- 查
error.log，不应出现：client intended to send too large body→ 说明client_max_body_size生效了could not open temp file→ 说明client_body_temp_path权限或空间有问题 - 抓包观察 HTTPS 流量是否持续稳定推进，无频繁重传或 RST
不复杂但容易忽略：这个参数管的是“能不能进门”，不是“进门后跑多快”。顺畅上传，靠的是它 + 合理超时 + 后端协同 + 网络质量四者齐备。
