Nginx 反向代理中遇到 413 Request Entity Too Large 怎么调整代理缓冲区-Nginx-PHP中文网

413错误由client_max_body_size限制直接触发，必须在匹配上传路径的location块中设置该值（如location /api/upload { client_max_body_size 200m; }），并确保后端限制（如spring boot的max-request-size）不低于此值，再通过nginx -s reload生效；proxy_buffering等参数仅影响上传稳定性，不解决413本身。

nginx 反向代理中遇到 413 request entity too large 怎么调整代理缓冲区

413 错误本身不是由代理缓冲区（proxy_buffering）直接导致的，而是由 client_max_body_size 限制触发的。但大文件上传时，若缓冲区配置不当，可能引发内存耗尽、超时或 502/500 等连带问题——所以“调整代理缓冲区”是上传稳定性优化的关键一环，而非解决 413 的主因。

先确认并调大 client_max_body_size

这是解决 413 的前提，必须优先处理：

在 location 块中设置（推荐，精准控制上传路径）：
```
location /api/upload {<br>  client_max_body_size 200M;<br>}
```
确保该值 ≤ 后端服务允许的最大请求体（如 Spring Boot 的 spring.servlet.multipart.max-request-size），否则 Nginx 放行后，后端仍会报 413
修改后执行 nginx -s reload 生效

再优化 proxy_buffering 相关配置（提升大文件上传稳定性）

当上传文件较大（如 >50MB）且开启 proxy_buffering on 时，Nginx 会将整个请求体缓存在内存或临时文件中，容易触发内存不足或写入失败。建议按场景调整：

Nginx

在宝塔面板中轻松管理Nginx高性能Web服务器。提供可视化配置反向代理、负载均衡、SSL证书及HTTP缓存功能，一键优化高并发性能，助您高效搭建稳定、快速的网站运行环境。

下载

对纯文件上传接口（如 /upload），关闭缓冲更稳妥：
proxy_buffering off;

若需保留缓冲，至少调大单个缓冲区和总缓冲空间：

proxy_buffer_size 128k;<br>proxy_buffers 8 16k;<br>proxy_busy_buffers_size 32k;

避免使用 proxy_max_temp_file_size 0（禁用磁盘临时文件），否则大请求可能直接失败；建议设为合理值，例如：
proxy_max_temp_file_size 2G;

注意 SSL 和 header 缓冲的配套设置

HTTPS 大文件上传还依赖 SSL 缓冲，而超长请求头（如含大量 token 或自定义字段）也可能间接影响处理流程：

SSL 缓冲通常默认足够，但若出现诡异中断，可微调：
ssl_buffer_size 16k;
请求头大小不影响 413，但若 header 过大（>8KB），可能触发 400 错误，可同步检查：
```
client_header_buffer_size 4k;<br>large_client_header_buffers 4 16k;
```