tool::http-status-detail
413 Content Too Large
The request body exceeds the server's size limit.
상태 코드
413
이름
Content Too Large
카테고리
4xx상세 설명
HTTP 413 Content Too Large(구 Request Entity Too Large)는 요청 본문의 크기가 서버에서 허용하는 최대 크기를 초과했음을 나타냅니다. 대용량 파일 업로드, 큰 JSON 페이로드, 또는 서버 설정의 크기 제한에 걸렸을 때 발생합니다. 서버는 처리를 중단하고 연결을 닫을 수 있습니다.
주요 원인
- ▸서버의 업로드 크기 제한을 초과하는 파일 업로드
- ▸API 요청 본문이 서버의 최대 페이로드 제한 초과
- ▸Nginx의 client_max_body_size 설정 초과
- ▸클라우드 함수의 요청 크기 제한 초과 (AWS Lambda: 6MB 등)
해결 방법
- 1.Nginx의 client_max_body_size 값을 늘리세요 (예: client_max_body_size 50M)
- 2.대용량 파일은 청크 업로드나 사전 서명 URL(Pre-signed URL) 방식을 사용하세요
- 3.JSON 페이로드를 줄이거나 페이지네이션을 적용하세요
- 4.Retry-After 헤더가 있으면 잠시 후 재시도하세요
관련 HTTP 헤더
Content-LengthRetry-After응답 예시
HTTP/1.1 413 Content Too Large
Content-Type: application/json
{"error":"payload_too_large","message":"Request body exceeds 10MB limit","maxSize":"10MB"}관련 상태 코드
400Bad RequestThe server could not understand the request due to invalid syntax.→401UnauthorizedAuthentication is required and has failed or not been provided.→402Payment RequiredReserved for future use; some services use it for payment walls.→403ForbiddenThe server refuses to fulfill the request (authenticated but unauthorized).→404Not FoundThe requested resource could not be found.→
ad · 300×250
// related tools