调整 client_body_buffer_size 主要解决大表单提交时的400错误或请求截断，它控制内存缓冲区大小而非最大上传限制，真正限制整体请求体的是 client_max_body_size，二者需协同配置。
调整 client_body_buffer_size 主要解决大表单（如含大量文本、多文件上传字段）提交时出现的 400 错误或请求被截断问题。它控制 Nginx 在内存中缓存客户端请求体的大小，超过该值才会写入临时文件——但若同时未配好 client_max_body_size 或磁盘权限，反而容易出错。
明确参数作用与常见误区
client_body_buffer_size 不是“最大允许上传大小”，而是“内存缓冲区大小”。真正限制整体请求体上限的是 client_max_body_size。两者需配合：
- 若表单原始数据 ≤
client_body_buffer_size，Nginx 全部存内存，处理最快； - 若超出，Nginx 将超出部分暂存到磁盘（路径由
client_body_temp_path指定），此时依赖磁盘空间和写入权限； - 若
client_max_body_size设得太小（如默认 1M），即使 buffer 调大，仍会直接返回 413 Request Entity Too Large； - 若只调大 buffer 却没放开
client_max_body_size，用户仍无法提交大表单。
合理设置 buffer size 的参考值
对纯文本大表单（如富文本编辑器提交长文章、JSON 配置批量导入），建议按典型负载估算：
- 普通表单（
- 含长文本字段（如 100KB 以内）：设为 128k～512k，避免频繁落盘；
- 混合表单（含 base64 图片 + 文本）：观察实际请求体大小（可通过浏览器 DevTools → Network → Payload 查看），buffer 值建议 ≥ 最大单次请求体的 1.2 倍；
- 不建议盲目设为几 MB——过大的内存 buffer 可能增加 worker 进程内存压力，尤其并发高时。
必须同步检查的关键配置
单独调 client_body_buffer_size 很难生效，以下三项需一并确认：
-
client_max_body_size：设为略大于业务预期最大表单体积（例如20m），单位支持k/m； -
client_body_temp_path：确保路径存在、Nginx worker 进程有写权限，且磁盘剩余空间充足（临时文件可能达client_max_body_size大小）； -
超时相关：大表单提交慢，需延长
client_header_timeout和client_body_timeout（例如设为12秒），避免连接中途断开。
验证与调试方法
改完配置后别急着 reload，先做这几步：
- 用
nginx -t检查语法； - 提交一个略超原 buffer 的表单，抓包或看 Nginx error log 是否出现
client intended to send too large body（说明client_max_body_size仍卡住）或could not open file（说明 temp path 权限/空间问题）； - 开启
error_log /path/to/error.log debug;（临时），可看到 buffer 使用详情，如using memory buffer或using temporary file； - 上线前用 curl 模拟测试：
curl -X POST --data-binary @large-form.json http://your.site/submit。
