client_body_temp_path配置需设多级子目录并挂载至高性能存储。推荐client_body_temp_path /var/nginx/client_temp 1 2，配nvme ssd+xfs，禁用atime，并验证目录分布与i/o路径。
Nginx 的 client_body_temp_path 配置直接影响大文件上传时的临时写入效率。它不只决定暂存位置，更关系到磁盘 I/O 负载分布、多级目录缓存友好性以及避免单目录 inode 瓶颈。关键在于路径设计、层级结构与底层存储特性的匹配。
合理设置多级子目录层级
Nginx 会按哈希自动分配子目录，但层级和每级字符数需手动指定。默认 client_body_temp_path /var/nginx/client_temp; 不带层级，所有临时文件挤在单目录下，易触发 ext4/xfs 的目录项查找性能下降（尤其文件数超万）。
- 推荐配置：
client_body_temp_path /var/nginx/client_temp 1 2;—— 表示两级子目录，第一级 1 字符，第二级 2 字符（如/a/bc/...），最多支持 256 × 65536 ≈ 1600 万个独立目录，充分分散文件 - 避免使用过深层级（如
3 3 3），会增加路径解析开销；也不宜过浅（如不设层级或仅1），起不到分流作用 - 确保父目录（如
/var/nginx/client_temp）已存在且 Nginx 工作进程有读写权限
将临时路径挂载到高性能存储设备
大文件上传期间，Nginx 先完整写入临时文件，再整体移交后端（如 FastCGI 或 proxy）。若临时路径落在机械盘或共享网络存储上，将成为明显瓶颈。
- 优先使用本地 NVMe SSD 分区单独挂载，例如：
/dev/nvme0n1p2 /var/nginx/client_temp xfs defaults,noatime,nodiratime 0 0 - 禁用
atime和diratime减少元数据写入；XFS 文件系统对大文件连续写入优化更好 - 避免与系统日志、其他服务共用同一物理磁盘，防止 I/O 争抢
配合 client\_max\_body\_size 与缓冲策略协同调优
client_body_temp_path 是否启用，取决于请求体是否超出内存缓冲区。Nginx 默认用 client_body_buffer_size（通常 8k–16k）缓存小请求体，超限才落盘。
- 对常规表单上传（client_body_buffer_size（如 128k），减少落盘频次
- 对确定的大文件上传（如 >10MB），保持 buffer 较小（默认即可），让 Nginx 尽早流式写入临时文件，避免内存积压
- 务必同步调整
client_max_body_size，否则大文件直接被 413 拒绝，根本不会走到 temp_path 阶段
监控与验证实际写入行为
配置生效后，不能仅依赖理论，需确认 Nginx 确实在使用目标路径且分布均匀。
- 上传一个大文件后，执行
ls -R /var/nginx/client_temp | head -20查看子目录结构是否符合预期层级 - 用
iotop -p $(pgrep nginx)观察 worker 进程实时磁盘写入，确认 I/O 主要发生在 client_temp 所在设备 - 检查 error log 中是否有
mkdir() failed (2: No such file or directory)，说明子目录创建失败，通常是权限或路径不存在
