Nginx를 사용하여 웹 서버를 운영하던 도중, 웹페이지에서 간혹 POST 요청을 보낼 때 HTTP Status Code 413을 리턴하며 요청에 실패하는 경우가 생깁니다.

413 Request Entity Too Large

Nginx 413 Request Entity Too Large 해결 방법

이 문제는 Nginx에서 POST 요청을 보낼 때 Body의 최대 크기를 초과한 데이터를 보냄으로서 발생한 문제입니다. 주로 파일을 첨부하거나 내용이 많은 텍스트를 함께 보낼 때 발생할 것입니다.

Nginx 문서에 나온 대로라면 별도로 지정하지 않았을 때의 기본값은 1MB에 불과할 정도로 작습니다.

결국 1MB 이상의 용량을 가진 데이터를 보낼 때 에러가 발생합니다. 따라서 Nginx 설정 파일에서 이 값을 늘린다면 문제가 해결 될 것입니다.

Nginx 설정 파일이 위치한 곳을 찾아 텍스트 에디터로 열어줍니다. 일반적으로 리눅스 계열 서버에서는 /etc/nginx/nginx.conf의 위치를 사용합니다.

$ vim /etc/nginx/nginx.conf

파일을 열었다면 다음 옵션을 검색합니다: client_max_body_size

옵션이 파일 내 존재한다면 해당 옵션의 값을 수정하고, 없다면 http 블록 안에 옵션을 추가해줍니다.

http {
    # ...
    client_max_body_size 100M;
    # ...
}

위 예시에서는 100M로 설정했습니다. M은 MB이며 Body 용량을 100MB까지 허용하겠다는 뜻입니다. 옵션과 값 사이에는 공백이 들어가야 하며 값 뒤에는 세미콜론(;)이 포함되어야 합니다.

파일을 저장하고 Nginx 설정을 갱신해줍니다. (이 명령을 사용하지 않으면 서버에 즉시 반영되지 않습니다.) 명령어는 대개 리눅스 서버에서 다음과 같습니다.

$ sudo service nginx reload # 오래된 서버에서 사용하는 경우
$ sudo systemctl reload nginx # 최근 서버에서 사용하는 경우 (동작하지 않을 경우 위 방법 시도)

이제 다시 요청을 보내 응답이 정상적으로 수신되는지 확인할 수 있습니다.