nginx 大表单稳定需合理设置 client_body_buffer_size：纯 json 表单设 64k～128k，含 base64 图片设 256k，富文本混合表单设 512k，并同步调大 client_max_body_size、后端接收限制及确保临时目录权限。
要让 Nginx 稳定支持大表单（比如含长文本、多字段、Base64 图片等的 POST 请求），client_body_buffer_size 的设定很关键——它直接决定表单数据是全程走内存，还是中途落盘写临时文件。
为什么大表单容易出问题
默认值通常只有 8k 或 16k，而一个带 Base64 头像的表单轻松超过 100KB；JWT Token + 多层嵌套 JSON 也可能达 64–128KB。一旦请求体超出缓冲区，Nginx 就会把多余部分写入磁盘临时文件，带来额外 I/O、延迟升高，甚至因磁盘满或权限不足导致 500 或 400 错误。
按表单类型选合适值
- 纯结构化 JSON 表单（无附件，含 JWT）：设为 64k～128k，覆盖 95% 场景，避免默认 16k 频繁溢出
- 含小图上传（如头像 Base64、截图粘贴）：建议 256k，兼顾内存开销与成功率
- 富文本+多附件混合表单（如工单系统）：可设 512k，但必须确认后端（如 Spring Boot 或 PHP）能完整读取
不能只调这一个参数
单独放大 client_body_buffer_size 没用，必须同步检查三项：
- client_max_body_size：必须 ≥ 缓冲区值，且不低于业务最大表单体积（例如设了 256k 缓冲，但 client_max_body_size 还是 1m，那 1.2M 表单仍会 413）
- 后端接收限制：Java 应用需调大 Tomcat 的 maxPostSize；PHP 要同步改 post_max_size 和 upload_max_filesize
- 临时路径权限：若缓冲区不够用，Nginx 会写 client_body_temp_path，确保该目录存在、Nginx 工作用户可写、磁盘有余量
推荐配置示例
针对常见后台表单接口，可在 location 块中单独设置：
location /api/submit {
client_max_body_size 10m;
client_body_buffer_size 256k;
client_body_temp_path /var/tmp/nginx/client_body 1 2;
}
这样既避免全局内存浪费，又精准适配表单路径，上线后观察 error.log 是否还有 “client intended to send too large body” 或 “buffered to a temporary file” 提示，就能验证是否生效。
