在 nginx 中，`client_body_buffer_size` 用于设置处理客户端请求体（如文件上传）时的缓冲区大小。默认值为 8k 或 16k（取决于平台）。如果请求体大小超过此值，nginx 会将超出部分写入临时文件，而将不超过该大小的部分保留在内存中。合理设置该参数可以减少磁盘 i/o，提高上传性能，但过大会占用过多内存。
如何根据业务需求调整 client_body_buffer_size？
调整 `client_body_buffer_size` 需要根据实际上传文件大小和服务器内存情况进行权衡。对于小文件上传（如图片、文档），设置为 16k-32k 通常足够；对于大文件上传，建议增大到 128k 或更高，以减少临时文件写入频率。同时需确保 `client_max_body_size` 允许更大的请求体，否则请求会被拒绝。
server {
listen 80;
server_name example.com;
# 设置上传缓冲区为 128k
client_body_buffer_size 128k;
# 允许最大上传大小为 50M
client_max_body_size 50m;
location /upload {
proxy_pass http://backend_server;
}
}
上述配置中，`client_body_buffer_size 128k` 表示 Nginx 会先尝试将最多 128KB 的请求体数据缓存在内存中。若上传文件小于等于 128KB，则无需写入临时文件，直接转发给后端服务。若大于 128KB，则超出部分写入临时文件（由 `client_body_temp_path` 指定路径），剩余部分仍留在内存。配合 `client_max_body_size 50m`，允许用户上传最大 50MB 的文件。测试时可使用 curl 发送不同大小的 POST 请求验证行为。
client_body_buffer_size 与临时文件的关系是什么？
`client_body_buffer_size` 决定了多少请求体数据可以保留在内存中，其余部分将被写入临时文件。临时文件的路径由 `client_body_temp_path` 控制，默认为 `$prefix/client_body_temp`。当请求体超过缓冲区大小时，Nginx 会自动创建临时文件并分块写入，这会增加磁盘 I/O 开销，但在内存有限的情况下是必要的折衷方案。
# 查看当前临时文件路径
nginx -V | grep -o 'client_body_temp_path=[^ ]*'
# 示例：手动指定临时文件路径
http {
client_body_temp_path /tmp/nginx_upload_temp;
client_body_buffer_size 64k;
}
通过上述命令可查看当前 Nginx 编译时默认的临时文件路径。也可以在配置文件中显式设置 `client_body_temp_path` 指向一个高速存储设备（如 SSD 或 tmpfs），以降低 I/O 延迟。例如，使用 `tmpfs` 挂载 `/dev/shm` 作为临时目录，可显著提升大文件上传时的性能。注意：临时文件在请求完成后会自动删除，无需手动清理。
当上传文件大小恰好等于 client_body_buffer_size 时会发生什么？
当上传文件大小恰好等于 `client_body_buffer_size` 时，Nginx 会将整个请求体保留在内存中，不会创建临时文件。这是因为缓冲区刚好容纳全部数据，无需溢出到磁盘。这是最理想的情况，既避免了磁盘 I/O，又未造成内存浪费。可通过压力测试工具模拟该边界条件进行验证。
# 使用 dd 生成恰好 128KB 的文件
dd if=/dev/zero of=testfile bs=1k count=128
# 使用 curl 上传
curl -X POST -H "Content-Type: application/octet-stream" \
--data-binary @testfile \
http://example.com/upload
# 观察 Nginx 错误日志，确认无临时文件创建记录
在上述测试中，若 `client_body_buffer_size` 设置为 128k，且上传文件正好为 128KB，则 Nginx 不会在 `client_body_temp_path` 目录下生成任何临时文件。所有数据均在内存中处理，随后转发给后端。这种行为符合预期，也证明了缓冲区大小与临时文件创建的临界点逻辑正确。开发者可通过监控磁盘 I/O 和内存使用情况进一步验证该机制。
