Nginx 파일 업로드 오류, 413 Request Entity Too Large 해결 방법

웹 서버에서 “413 Request Entity Too Large” 오류를 마주친 적이 있으신가요? 이 오류는 서버가 업로드된 파일의 크기를 처리할 수 없을 때 발생하는 문제입니다. 이 글에서는 이 오류가 발생하는 원인과 이를 해결하는 방법을 단계별로 설명드리겠습니다.

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 값을 조정해야 합니다. 기본적으로 이 값이 너무 낮게 설정되어 있을 수 있기 때문에 아래와 같은 절차로 수정하세요.

  1. 터미널에서 Nginx 설정 파일을 엽니다. 일반적으로 /etc/nginx/nginx.conf 또는 가상 호스트 설정 파일에 위치해 있습니다.
  2. 설정 파일 내 http 블록이나 server 블록에 다음과 같이 client_max_body_size 지시어를 추가하거나 수정합니다.
   http {
       ...
       client_max_body_size 64M;  # 업로드 가능한 최대 파일 크기를 설정 (예: 64MB)
       ...
   }
  1. 설정 파일을 저장한 후 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 파일에서 업로드 크기를 직접 설정함으로써 문제를 해결할 수 있습니다. 이러한 단계를 통해 웹 사이트에서 대용량 파일 업로드 시 발생할 수 있는 문제를 손쉽게 해결해 보세요.

Leave a Comment