client_body_in_file_only 是 Nginx 调试指令，强制将全部客户端请求体写入临时文件而非内存，便于排查大文件上传及后端交互问题；设为 on 时所有请求体落盘，off 为默认（小体内存、大体落盘），clean 为落盘后立即删除；仅对使用 client_body_buffer_size 且读取请求体的上下文生效；需配置 client_body_temp_path 并确保权限与空间充足，切勿长期用于生产环境。
client_body_in_file_only 是 Nginx 的一个调试型指令，它强制将客户端请求体（request body）**全部写入临时文件**，不保留在内存中。这在排查大文件上传、请求体读取异常、或与后端（如 FastCGI、proxy_pass）交互问题时非常有用——你可以直接查看磁盘上的原始请求体内容。
作用与适用场景
该指令不改变请求逻辑，仅影响 Nginx 内部如何缓存请求体：
- 设为 on：所有请求体（无论大小）都跳过内存缓冲，直接落盘到
client_body_temp_path指定的目录； - 设为 off（默认）：小请求体走内存，大请求体才写临时文件；
- 设为 clean：落盘后请求结束立即删除临时文件（仍可用于调试，但需在请求处理中快速捕获）。
注意：它只对使用了 client_body_buffer_size 且实际读取了请求体的上下文生效（例如含 proxy_pass、fastcgi_pass、或使用了 $request_body 变量的配置）。
基础配置步骤
在 http、server 或 location 块中添加以下指令：
- 确保已设置临时路径：
client_body_temp_path /var/tmp/nginx/client_body 1 2;（路径需 Nginx 进程可写，层级参数可选）； - 启用强制落盘：
client_body_in_file_only on;； - （可选）增大超时和缓冲限制，避免因大体被截断：
client_max_body_size 100m;、client_body_timeout 60s;； - 重载 Nginx：
nginx -s reload。
如何定位并查看生成的请求体文件
Nginx 不会直接命名文件为原始请求名，而是用内部哈希+序号生成临时文件（如 0000000001），存放于 client_body_temp_path 对应子目录中。调试时可：
- 在对应 location 中加日志记录文件路径：
log_format debug_body '$request_body_file';，再用access_log /var/log/nginx/debug.log debug_body;； - 或利用
$request_body_file变量，在响应头中透出（仅限调试环境）：add_header X-Body-File $request_body_file;； - 收到请求后，立刻进入 temp 目录（如
/var/tmp/nginx/client_body/0/00），用ls -t | head -n 3找最新文件，再用cat或xxd查看二进制内容。
注意事项与常见问题
这个指令是纯调试用途，**切勿在生产环境长期开启**：
- 每次请求都写磁盘，显著降低性能，尤其高并发时；
- 临时文件不会自动清理，需配合监控或定时脚本（如
find /var/tmp/nginx/client_body -mmin +5 -delete）； - 如果后端服务（如 PHP-FPM）未正确读取
CONTENT_LENGTH或未从文件读取 body，可能造成空体； - POST 表单（
application/x-www-form-urlencoded）和 JSON 都会被完整保存，但 multipart 文件字段的内容也包含在内，需注意边界解析。
不复杂但容易忽略：务必确认 Nginx 有权限写入 temp 目录，且磁盘空间充足——否则请求会直接失败返回 413 或 500。
