413 Request Entity Too Large 是 Nginx 在接收请求体时,发现实际大小超过 client_max_body_size 配置值后直接返回的响应。对于反向代理中转站,最常见的触发点是 Nginx 默认值为 1m,而客户端上传的文件或表单体超过这个值。这个错误通常由代理层直接拦截,客户端收到 413,后端应用日志里看不到对应请求。判断的第一步,是确认 413 来自中转站还是后端服务。
先确认 413 的返回方
先用 curl 带一个超过当前限制的文件发起请求,观察响应头:
curl -s -D - -o /dev/null -F "file=@large.bin" http://your-proxy/upload/如果响应头里的 Server 是中转站 Nginx,且中转站 access log 里记录了该请求的 413 状态码,说明请求还没到达后端。如果中转站日志显示 200 或 413 由后端返回,再看后端自己的限制。另外,Nginx error.log 通常会有 "client intended to send too large body" 一行,用于定位具体是哪个 server/location 拒绝的。
调整位置:http、server 还是 location
client_max_body_size 可以在 http、server、location 三个层级设置,作用范围依次缩小。中转站如果只服务一个业务域,放在 server 块即可;如果某些路径允许大文件,其他路径保持默认限制,就放在对应 location 块。
server {
listen 80;
server_name relay.example.com;
client_max_body_size 20m;
location /upload/ {
client_max_body_size 100m;
proxy_pass http://backend;
}
}这个示例里,/upload/ 路径允许最大 100m,同 server 其他路径受 20m 限制。修改后用 nginx -t 检查语法,再 nginx -s reload 生效。注意:client_max_body_size 限制的是请求体大小,不影响响应体,也不影响请求头;请求头过大返回的是 431。
中转站场景的两个关键点
第一,proxy_request_buffering 默认开启,Nginx 会先把整个请求体收完再转发给后端。即使关闭此选项,client_max_body_size 依然生效。如果你看到上传过程中连接中断,且 access log 没有 413,要检查 client_body_timeout 是否因为慢上传而超时。
第二,后端服务也有自己的请求体限制。中转站放宽后,如果后端是 Nginx,同样需要调整;如果后端是 PHP,需要看 upload_max_filesize 和 post_max_size;Java 服务则看 multipart 配置。后端返回的 413 会被中转站原样传回客户端,此时中转站日志能看到上游响应的状态码。
常见误区与验证步骤
- 误区一:认为调大 client_max_body_size 会影响性能。实际上它只做大小检查,真正的内存占用由 proxy_buffering、client_body_buffer_size 等参数控制。
- 误区二:只在 http 块设置。如果某个 server 块里没有继承,默认继承 http 设置;但要注意有些配置模板会在 server 块显式覆盖。
- 误区三:忽略负载均衡路径。如果中转站前面还有一层 LB,那一层的请求体限制同样要确认。
验证时不要只看浏览器提示。用 dd 生成指定大小文件,再用 curl -F 上传,配合 access log 和 error log 确认状态码来源。例如生成 30m 测试文件:
dd if=/dev/zero of=test30m.bin bs=1M count=30先确认当前限制,再逐步调整配置并验证,是排查 413 最直接的路径。如果调整后仍收到 413,重点检查是否有多层代理、后端自身限制,以及是否有其他配置模板覆盖了你的设置。