意義
請求本文超過伺服器願意或能夠處理的大小。舊稱 Payload Too Large。
常見原因
- 上傳超過 nginx 的 client_max_body_size(預設 1 MB)
- PHP 的 upload_max_filesize 或 post_max_size 太小
- API 閘道或無伺服器平台的本文限制
解決方法
用戶端或訪客
壓縮或分割上傳內容,或使用服務提供的可續傳或分段上傳 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."
} 規範
常見問題
› 如何在 nginx 中解決 413?
在 http、server 或 location 區塊調高 client_max_body_size,例如 client_max_body_size 50m;,然後重新載入 nginx。
› 為什麼調高應用程式限制後仍是 413?
反向代理、CDN 或負載平衡器等其他層有自己更低的限制。