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。