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

另見