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

另請參閱