413 内容过大

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

在 RFC 9110 之前，该状态码的响应短语为 有效负载过大。此消息仍在广泛使用。

状态

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

另请参阅