의미
요청 본문이 서버가 처리하려 하거나 처리할 수 있는 크기보다 큽니다. 예전 이름은 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, 로드 밸런서 같은 다른 계층에 더 낮은 자체 제한이 있기 때문입니다.