413 Content Too Large

HTTP 413 Content Too Large 客户端错误响应状态码表示请求实体大于服务器定义的限制。服务器可能会关闭连接或返回一个 Retry-After 头部字段。

RFC 9110 之前,此状态的响应短语是 Payload Too Large。此消息仍被广泛使用。

状态

http
413 Content Too Large

示例

文件上传超出限制

以下示例展示了当 <input type="file"> 元素在表单提交时(使用 method="post")包含一张图片时,客户端可能会发送的内容

http
POST /upload HTTP/1.1
Host: example.com
Content-Type: multipart/form-data; boundary=----Boundary1234
Content-Length: 4012345

------Boundary1234
Content-Disposition: form-data; name="file"; filename="myImage.jpg"
Content-Type: image/jpeg

\xFF\xD8\xFF\xE0\x00...(binary data)
------Boundary1234--

如果服务器对它将处理的最大文件大小有限制,并且响应体包含一个带有上下文的 message,则服务器可能会拒绝上传。

http
HTTP/1.1 413 Content Too Large
Content-Type: application/json
Content-Length: 97

{
  "error": "Upload failed",
  "message": "Maximum allowed upload size is 4MB",
}

规范

规范
HTTP 语义
# status.413

另见