웹 서버를 운영하다 보면 파일 업로드 시 413 Request Entity Too Large 에러를 만나는 경우가 있습니다. 이 오류는 업로드하려는 파일 크기가 Nginx 설정에서 허용된 최대 크기를 초과했을 때 발생합니다. 특히 이미지, 동영상, 문서 업로드 기능이 있는 서비스에서 자주 발생하는 문제입니다.

413 Request Entity Too Large 원인

이 에러의 원인은 Nginx 설정 중 client_max_body_size 지시어 때문입니다.

• client_max_body_size : 클라이언트가 업로드할 수 있는 최대 요청 본문 크기를 지정합니다.
• 기본값은 1MB이므로, 큰 파일을 업로드하면 자동으로 차단됩니다.

해결 방법 : Nginx 설정 변경

• 예상 위치: /etc/nginx/nginx.conf

가장 일반적인 해결책은 nginx.conf 혹은 사이트 설정 파일에 client_max_body_size 값을 늘려주는 것입니다.

http {
    client_max_body_size 5M;

    server {
        ...
    }
}

• http 블록 : 전체 서버에 적용
• server 블록 : 특정 도메인에만 적용
• location 블록 : 특정 경로 업로드에만 적용

업로드 제한을 넉넉하게 두고 싶다면 50M이나 100M 정도로 지정할 수 있습니다.

Nginx 재시작

설정을 바꾼 후에는 반드시 Nginx를 재시작해야 적용됩니다.

sudo nginx -t   # 설정 문법 체크
sudo systemctl reload nginx   # 무중단 반영