[Nginx] 업로드 파일 용량 초과 오류

nginx logo

개  요

Nginx사용 시 File Upload 서비스를 수행하다가 HTTP 413 client intended to send too large body 에러를 확인한 경우 해결하는 방법을 정리하였다.

Nginx 413 Error Page

1. 원  인

Nginx의 경우 최대 용량을 지정하는 옵션인 client_max_body_size가 있다. 해당 옵션 값의 기본값은 1m이며 HTTP Client의 Content-Length 헤더값이 이보다 클 경우 Nginx는 HTTP 413 Error(Requeset Entity Too Large)를 전송하며 위와 같은 메시지 화면을 보여준다.

Nginx 로그에는 아래와 같은 내용이 확인 된다.

2024/10/15 05:54:59 [error] 242: *160826 client intended to send too large body: 1326711 bytes, client: 10.16.0.0, server: www.jsh.co.kr, request: "POST /fileupload HTTP/2.0", host: "www.jsh.co.kr", referrer: "https://www.jsh.co.kr/boardWrite"

2. 해결방법

client_max_body_size값을 늘려주거나 사이즈 제한을 하지 않도록 0을 설정한 뒤 Nginx를 재 기동하면 된다.

client_max_body_size는 server, location, http 영역에서 모두 설정이 가능하다.

아래는 nginx.conf 설정 예시이다.

server {
  ...
  client_max_body_size 0;
  ...
}