웹 서버에서 “413 Request Entity Too Large” 오류를 마주친 적이 있으신가요? 이 오류는 서버가 업로드된 파일의 크기를 처리할 수 없을 때 발생하는 문제입니다. 이 글에서는 이 오류가 발생하는 원인과 이를 해결하는 방법을 단계별로 설명드리겠습니다.
413 Request Entity Too Large 오류란?
“413 Request Entity Too Large” 오류는 클라이언트(사용자)가 서버로 전송하려는 파일이 서버에서 허용하는 최대 크기를 초과했을 때 발생하는 HTTP 상태 코드입니다.
주로 워드프레스 플러그인이나 대용량 파일을 업로드할 때 이러한 오류가 발생합니다. 이 오류는 Nginx와 같은 웹 서버에서 자주 볼 수 있으며, 서버 설정에 따라 쉽게 해결할 수 있습니다.
Nginx 설정 변경하기
Nginx를 사용하는 서버에서 “413 Request Entity Too Large” 오류를 해결하려면 Nginx 설정 파일에서 client_max_body_size
값을 조정해야 합니다. 기본적으로 이 값이 너무 낮게 설정되어 있을 수 있기 때문에 아래와 같은 절차로 수정하세요.
- 터미널에서 Nginx 설정 파일을 엽니다. 일반적으로
/etc/nginx/nginx.conf
또는 가상 호스트 설정 파일에 위치해 있습니다. - 설정 파일 내
http
블록이나server
블록에 다음과 같이client_max_body_size
지시어를 추가하거나 수정합니다.
http {
...
client_max_body_size 64M; # 업로드 가능한 최대 파일 크기를 설정 (예: 64MB)
...
}
- 설정 파일을 저장한 후 Nginx를 재시작합니다.
sudo systemctl restart nginx
이 과정을 통해 서버가 허용하는 업로드 파일 크기를 증가시켜 오류를 해결할 수 있습니다.
PHP 설정 변경하기
Nginx 설정 외에도 PHP 설정에서 파일 업로드 크기를 조정해야 할 수 있습니다. PHP 설정 파일 (php.ini
)에서 아래의 두 가지 설정을 확인하고 수정하세요.
upload_max_filesize
: 업로드 가능한 파일의 최대 크기 설정post_max_size
: POST 요청을 통해 서버로 보낼 수 있는 데이터의 최대 크기 설정
다음과 같이 설정 파일을 열어 값을 변경합니다:
upload_max_filesize = 64M
post_max_size = 64M
수정을 완료한 후 PHP-FPM을 재시작해야 설정이 적용됩니다. PHP 8.0을 사용하는 경우 다음 명령어로 재시작합니다:
sudo systemctl restart php8.0-fpm
WordPress 설정에서 파일 업로드 크기 조정하기
추가적으로 워드프레스에서 직접 업로드 크기 제한을 변경할 수도 있습니다. wp-config.php
파일에 아래와 같은 코드를 추가하여 업로드 제한을 늘릴 수 있습니다:
@ini_set( 'upload_max_size' , '64M' );
@ini_set( 'post_max_size', '64M');
@ini_set( 'max_execution_time', '300' );
이렇게 하면 워드프레스에서 파일을 업로드할 때 발생하는 “413 Request Entity Too Large” 오류를 줄이는 데 도움이 됩니다.
결론
“413 Request Entity Too Large” 오류는 서버가 클라이언트가 전송하려는 파일 크기를 허용하지 않을 때 발생합니다.
이를 해결하기 위해서는 Nginx 설정에서 client_max_body_size
값을 늘리고, PHP 설정에서 업로드와 POST 크기 제한을 조정해야 합니다.
또한 워드프레스의 wp-config.php
파일에서 업로드 크기를 직접 설정함으로써 문제를 해결할 수 있습니다. 이러한 단계를 통해 웹 사이트에서 대용량 파일 업로드 시 발생할 수 있는 문제를 손쉽게 해결해 보세요.