워드프레스에서 XML 파일 등 데이터를 업로드하여 임포트하려고 시도할 때 413 Request Entity Too Large 에러가 발생하면서 실패하는 경우가 있습니다.

클라우드웨이즈(Cloudways)와 Vultr의 Plesk 패널에서 대용량 Kboard 백업 파일을 복구하기 위해 업로드하니 업로드 프로세스가 조금 진행 되다가 위와 같은 에러가 발생하면서 업로드 자체가 되지 않는 문제를 경험했습니다.
이 경우 Uplaod Max Filesize와 Post Max Size 설정값을 임포트하려는 파일 크기보다 크게 설정하면 문제가 발생하지 않을 것입니다. nginx의 경우 client_max_body_size 크기를 확인하여 조정해야 할 수 있습니다.
📍 클라우드웨이즈 가입 방법 (+ Cloudways 할인 쿠폰 & 프로모션 코드)
워드프레스 Request Entity Too Large 오류 해결하기
Request Entity Too Large 에러가 발생하는 경우 다음과 같은 설명이 함께 표시될 수 있습니다.
The requested resource does not allow request data with POST requests, or the amount of data provided in the request exceeds the capacity limit
이 오류는 POST 요청을 통해 서버로 전송되는 데이터의 양이 서버 설정에서 지정된 제한 크기를 초과할 때 발생합니다.
이 문제가 발생하면 다음과 같은 PHP 설정을 확인하여 조정해야 할 수 있습니다.
- post_max_size: 이 값은 POST 방식으로 데이터를 전송할 때 최대 허용 크기를 설정하며, 이 값은 임포트하려는 데이터 파일(예: XML 파일)의 크기보다 크게 설정되어야 합니다. 예를 들어, 100MB의 XML 파일을 업로드하려면 이 값을 100MB 이상으로 설정해야 합니다.
- upload_max_filesize: 업로드 가능한 파일 최대 크기를 정의합니다. 이 값도 데이터 파일 크기보다 크게 조정해야 합니다.
- memory_limit: 스크립트가 사용할 수 있는 최대 메모리 양. 메모리 제한 크기 설정값도 충분히 크게 설정하여 스크립트가 데이터를 처리할 수 있도록 해야 합니다.
웹서버가 nginx인 경우에는 클라이언트 요청 본문의 최대 크기를 설정하는 client_max_body_size 값을 조정해야 합니다. 이 값은 웹 서버 설정에서 다음과 같이 변경할 수 있습니다.
client_max_body_size 100M;
.htaccess 파일을 통한 PHP 설정값 변경하기
카페24 등 일부 웹호스팅에서는 .htaccess 파일에 코드를 추가하여 메모리 제한 크기, 최대 파일 업로드 크기, 포스트 최대 크기 등의 설정값을 제어할 수 있습니다. 예시:
php_value upload_max_filesize 512M
php_value post_max_size 512M
php_value memory_limit 512M
일부 웹호스팅에서는 메모리 제한 크기 등의 설정을 조정하지 못할 수 있습니다. 예를 들어, 가비아에서는 memory_limit가 256MB로 고정되어 있고, 이 값을 변경할 수 없습니다. 이 경우 엘리멘터 페이지 빌더나 아바다 테마 등 많은 메모리를 요구하는 일부 플러그인이나 테마가 제대로 작동하지 않을 수 있습니다.
클라우드웨이즈(Cloudways)에서 PHP 설정값 변경하기
클라우드웨이즈를 이용하는 경우 서버 관리 페이지에서 PHP 관련 설정값을 조정할 수 있습니다.
Settings & Packages » Basic으로 이동하여 Uplaod Size와 Memory Limit 크기를 변경하도록 합니다.

Post Max Size 크기는 애플리케이션 설정에서 조정이 가능합니다. Application Settings » PHP FPM Settings에서 원하는 PHP 설정을 변경할 수 있습니다.

개별 애플리케이션의 PHP 설정을 변경하려는 경우 이 방법을 이용할 수 있습니다.
Vultr의 Plesk 패널을 사용하는 경우
Vultr는 서버를 직접 운영해야 하기 때문에 초보자에게는 쉽지 않은 옵션일 수 있습니다. PHP 설정은 Websites & Domains » Dashboard » Dev Tools의 PHP 섹션에서 변경할 수 있습니다.

그리고 nginx 웹 서버의 client_max_body_size 설정값도 조정해야 합니다.
Websites & Domains » Hosting & DNS » Apache & nginx를 클릭한 다음, 맨 아래의 Additional nginx directives 부분에 다음과 같은 지시문을 추가합니다.

만약 에러가 발생하는 경우에는 nginx 설정 파일을 찾아서 수정해야 합니다. nginx 설정 파일은 일반적으로 /etc/nginx/nginx.conf 또는 /etc/nginx/sites-available/ 디렉터리 내의 특정 사이트 설정 파일에 있을 수 있습니다.
적용한 후에 PHP-FPM와 nginx (또는 관련 서비스)를 재시작합니다. Plesk 패널에서는 Tools & Settings » Server Management » Services Management에 접속하여 관련 서비스를 재가동할 수 있습니다.
SSH에 접속하여 서비스를 재시작할 수도 있습니다. 예시) nginx 웹서버 재시작:
sudo systemctl restart nginx
PHP 설정값 확인하기
워드프레스의 사이트 건강 도구에서 일부 서버 설정값을 확인할 수 있습니다.

만약에 “post_max_size” 값이 “upload_max_filesize”보다 작은 경우에는 다음과 같은 경고가 표시됩니다.
“post_max_size” 값은 “upload_max_filesize”보다 작습니다.
post_max_size 설정이 upload_max_filesize보다 작습니다. 파일 업로드 할 때 문제가 생길 수 있습니다.
클라우드웨이즈에서 PHP post max size(포스트 최대 크기)는 기본적으로 Upload max filesize(업로드 최대 파일 크기) 값과 동일하게 설정되는 것 같습니다.
Avada 테마나 Newspaper 테마 등을 사용하는 경우 테마 옵션 내에서 PHP 설정값을 확인할 수 있습니다.

마치며
워드프레스 사이트에서 파일 업로드 시 413 Request Entity Too Large 에러가 발생하는 경우 파일 최대 업로드 크기와 Post Max Size 등의 설정을 확인하여 값을 조정하면 문제가 해결될 수 있습니다.
PHP 설정이나 nginx 설정 변경 방법에 대하여 모르는 경우 웹호스팅 업체에 연락하여 안내를 받을 수 있습니다.
워드프레스나 웹호스팅 관련 문제로 어려움을 겪는 경우 여기에서 서비스(유료)를 요청하실 수 있습니다.
댓글 남기기