Nginx를 사용하여 웹 서버를 운영하던 도중, 웹페이지에서 간혹 POST 요청을 보낼 때 HTTP Status Code 413을 리턴하며 요청에 실패하는 경우가 생깁니다.
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 # 최근 서버에서 사용하는 경우 (동작하지 않을 경우 위 방법 시도)
이제 다시 요청을 보내 응답이 정상적으로 수신되는지 확인할 수 있습니다.
리눅스 명령어 - kill, killall 리눅스 kill 명령어는 특정 프로세스를 종료해주는 명령어입니다. 백그라운드에서 실행되고 있는…
JavaScript는 역사가 긴 스크립트 프로그래밍 언어입니다. 세월이 흐르면서 많은 자바스크립트 표준이 만들어졌고, 현재는 많은 문법적…
NodeJS 테스트 프레임워크인 Mocha는 비동기 테스트를 지원합니다. 간혹 특정 테스트 스크립트를 작성하고 실행하면 아래와 같이…
언제부턴가 윈도우 11을 처음 설치할 때 마이크로소프트(Microsoft) 계정 로그인을 강제로 요구하게 되었습니다. 물론 마이크로소프트 계정이…
애플 에어팟 프로 2 (AirPods Pro 2) 케이스에는 스피커가 내장되어 있습니다. 그런데 간혹 아무 것도…