需指定独立临时盘以避免系统盘空间不足或i/o压力导致上传失败；正确配置client_body_temp_path需设独立磁盘路径、合理层级（如2 2）、配合client_max_body_size等参数，并验证临时文件生成及日志报错。
在 Nginx 中，client_body_temp_path 用于指定客户端请求体（尤其是文件上传）的临时存储路径。当用户上传大文件时，Nginx 默认会把整个请求体先写入磁盘临时文件，再交给后端（如 FastCGI、proxy_pass 等）处理。若不显式配置该指令，Nginx 会使用编译时指定的默认临时目录（通常是 /usr/local/nginx/client_body_temp 或 /var/cache/nginx/client_body_temp），而这个路径往往位于系统盘（如 / 或 /var），容易因空间不足或 I/O 压力导致上传失败。
为什么需要指定独立的临时盘？
大文件上传过程中，Nginx 会按块接收并写入临时文件，直到整个请求体接收完成。该过程：
- 占用连续磁盘空间（单个上传对应一个临时文件）
- 对磁盘 I/O（尤其是随机写）有明显压力
- 若系统盘空间小或被其他服务共用，易触发
500或413 Request Entity Too Large（实际是写入失败但报错不直观） - 多并发上传时，临时文件数量和大小叠加，风险更高
如何正确配置 client_body_temp_path？
语法为：client_body_temp_path path [level1 [level2 [level3]]];
其中 path 必须是本地已存在、Nginx worker 进程有读写权限的目录；level1/level2/level3 是可选的子目录层级（用于分散 inode，避免单目录文件过多），每级最多 10 进制一位数（如 1、2），常用 1 2 或 2 2 2。
示例（推荐）：
client_body_temp_path /data/nginx/temp 2 2;
含义：将临时文件存放在 /data/nginx/temp 下，按两级子目录哈希组织（如 /data/nginx/temp/ab/cd/xxxxxx），提升大目录下的文件查找与清理效率。
操作步骤：
- 准备一块独立磁盘（如挂载在
/data），确保剩余空间 ≥ 单次最大上传 × 并发数 × 1.2（留缓冲） - 创建目录并授权：
mkdir -p /data/nginx/temp<br> chown nginx:nginx /data/nginx/temp<br> chmod 700 /data/nginx/temp
（假设 worker 用户为nginx） - 在
http、server或location块中添加配置（通常放http块全局生效） - 重载 Nginx：
nginx -s reload
配套必须调整的关键参数
client_body_temp_path 单独配置不够，还需协同以下指令防止上传被拦截或异常中断：
-
client_max_body_size：明确允许的最大请求体大小（如2000m），否则默认仅 1MB，超限直接返回 413 -
client_body_buffer_size：内存缓冲区大小（如128k）。若请求体 ≤ 此值，Nginx 就不写磁盘，直接进内存；超过才落盘到client_body_temp_path。调大可减少小文件落盘，但不解决大文件问题 -
client_body_timeout：控制接收请求体的超时时间（如300s），避免慢速上传被中断
完整典型配置片段：
http {
client_max_body_size 2000m;
client_body_buffer_size 128k;
client_body_timeout 300;
client_body_temp_path /data/nginx/temp 2 2;
server {
listen 80;
location /upload {
proxy_pass http://backend;
proxy_set_header X-Real-IP $remote_addr;
}
}
}
验证与排错要点
配置生效后，可通过以下方式确认：
- 上传一个大于
client_body_buffer_size的文件（如 5MB），然后执行ls -lR /data/nginx/temp，应能看到新生成的临时文件（命名类似0000000001） - 检查 Nginx 错误日志（
error.log），关注是否有open() "/data/nginx/temp/..." failed (2: No such file or directory)或(28: No space left on device)类报错 - 用
df -h /data和iostat -x 1监控目标磁盘空间与 I/O 利用率 - 注意：临时文件在请求处理完成后由 Nginx 自动清理，无需手动干预；若 worker 异常退出，残留文件需定期用
find /data/nginx/temp -type f -mmin +60 -delete清理（谨慎加定时任务）
