DevToolPal
简
4xx 客户端错误

413 Content Too Large

内容过大

含义

请求体超过了服务器愿意或能够处理的大小。以前称为 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."
}

规范

RFC 9110 §15.5.14

常见问题

› 如何在 nginx 中解决 413?

在 http、server 或 location 块中调大 client_max_body_size,例如 client_max_body_size 50m;,然后重新加载 nginx。

› 为什么调大应用限制后仍然 413?

反向代理、CDN 或负载均衡器等其他层有自己更低的限制。