client_body_buffer_size 是 Nginx 控制请求体内存缓冲大小的关键参数，决定是否触发临时文件写入；需结合上传大小、并发量与资源调优，并同步检查 client_max_body_size、client_body_temp_path 和 client_body_timeout。
client_body_buffer_size 是 Nginx 中控制客户端请求体（request body）在内存中缓冲大小的关键参数，直接影响上传性能、内存占用和是否触发临时文件写入。调优它不是单纯“设大一点”，而是要结合业务场景、上传文件大小分布和服务器资源来平衡。
理解它的作用机制
当客户端发起 POST 或 PUT 请求并携带数据（如表单提交、文件上传）时，Nginx 默认先将请求体暂存在内存缓冲区。若数据量 ≤ client_body_buffer_size，整个过程在内存中完成，高效且无磁盘 I/O；若超过该值，Nginx 会把超出部分写入临时文件（路径由 client_body_temp_path 指定），再由后端（如 PHP-FPM、FastCGI 或 proxy_pass 目标）读取——这会增加延迟和磁盘压力。
常见合理取值参考
- 纯 API 接口（JSON 小数据）：默认 8k 或 16k 已足够，无需调整
- 普通表单含图片（如头像上传，≤2MB）：建议设为 128k ~ 512k
- 支持中大型文件上传（如文档、压缩包，≤20MB）：可设为 2m ~ 4m，但需同步检查 client_max_body_size 是否匹配
- 高并发小上传场景（如移动端频繁 JSON 提交）：适当调小（如 4k）可降低单连接内存占用，提升整体并发能力
必须同步检查的关联配置
单独调大 client_body_buffer_size 并不生效，还需确认：
- client_max_body_size：限制请求体总大小（默认 1m），必须 ≥ 缓冲区大小，否则大请求直接被 413 错误拦截
- client_body_temp_path：确保该路径存在、可写，且所在磁盘有足够空间和 I/O 余量（尤其开启临时文件时）
- client_body_timeout：避免慢速上传长期占着缓冲区，建议设为 10~60 秒
验证与监控建议
调优后不能只看“不报错”，要实际观测：
- 查看 Nginx error log 中是否仍有 "client intended to send too large body" 或 "could not open temp file" 类错误
- 用 nginx -t 检查语法，reload 后观察 ps aux | grep nginx 内存增长是否异常
- 对上传接口做压测（如用 wrk 或 ab），对比缓冲区内存处理 vs 临时文件处理的平均延迟和错误率
