含义
请求体超过了服务器愿意或能够处理的大小。以前称为 Payload Too Large。
常见原因
- 上传超过 nginx 的 client_max_body_size(默认 1 MB)
- PHP 的 upload_max_filesize 或 post_max_size 太小
- API 网关或 Serverless 的请求体限制
解决方法
客户端或访问者
压缩或拆分上传内容,或使用服务提供的可续传或分片上传 API。
网站或 API 的维护者
在每一层都提高限制:代理(client_max_body_size)、应用框架和网关。在错误信息中说明限制大小。
响应示例
HTTP/1.1
HTTP/1.1 413 Content Too Large
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Connection: close
Content-Type: application/problem+json
{
"type": "about:blank",
"title": "Content Too Large",
"status": 413,
"detail": "Uploads are limited to 10 MB."
} 规范
常见问题
› 如何在 nginx 中解决 413?
在 http、server 或 location 块中调大 client_max_body_size,例如 client_max_body_size 50m;,然后重新加载 nginx。
› 为什么调大应用限制后仍然 413?
反向代理、CDN 或负载均衡器等其他层有自己更低的限制。