워드프레스, 테마, 플러그인의 설치나 업데이트가 실패하는 경우

워드프레스나 테마, 플러그인을 설치하거나 업데이트할 때 오류가 발생하는 문제와 관련된 질문이 많이 올라와서 이와 관련된 문제를 해결하는 방법을 정리해보았습니다.

이 블로그의 이전 글에서도 비슷한 문제를 다루었지만 개별적인 문제(예: 워드프레스 테마 설치 오류)에 대해 설명하고 있습니다. 다음과 같은 문제의 경우 원인과 해결 방법은 비슷합니다.

  1. 워드프레스 코어 설치/업데이트 실패
  2. 워드프레스 테마/데모 설치/업데이트 실패
  3. 워드프레스 플러그인 설치/업데이트 실패
  4. 이미지 업로드 실패

이와 관련하여 다음과 같은 오류 메시지가 표시될 수 있습니다.

Your browser sent a request that this server could not understand.

- 또는 -

업로드된 파일이 wp-content/uploads/2018/06 로 옮겨질 수 없습니다

- 또는 -

https://downloads.wordpress.org/release/ko_KR/wordpress-4.9.6.zip로부터 업데이트 다운로드.
업데이트 압축 푸는 중.
디렉터리를 생성할 수 없습니다.
설치 실패

이와 같은 문제가 발생하는 경우 다음 사항을 체크해보시기 바랍니다. 아래의 방법으로 대부분의 문제가 해결될 수 있지만, 모든 문제가 해결될 것이라고 보장하지 않으며 특정 문제는 해결되지 않을 수도 있습니다.

워드프레스, 테마, 플러그인의 설치나 업데이트가 실패하는 경우 확인 사항

웹호스팅 서버 디스크 공간 부족

업로드 실패 관련 문제는 많은 경우 웹호스팅 디스크 공간 부족으로 인해 발생할 수 있습니다. 특히 카페24의 저가 호스팅이나 닷홈 무료 호스팅을 이용하는 경우 워드프레스 테마를 설치하고 이미지 몇 개를 올리면 금방 디스크 공간이 소진될 수 있습니다.

먼저 웹호스팅 업체 사이트에 로그인하여 디스크 공간이 충분한지 확인하시기 바랍니다. 카페24에서는 호스팅관리 » 사용량 모니터링에서 디스크와 트래픽 사용량을 확인할 수 있습니다.

카페24에서 디스크 용량 확인하기

만약 디스크(웹하드) 용량이 얼마 남지 않았다면 디스크 용량을 추가하거나 웹호스팅 상품을 업그레이드할 수 있습니다. 저렴하게 괜찮은 호스팅을 이용하고 싶은 경우 우리나라에 잘 알려진 해외 호스팅인 클라우드웨이즈패스트코멧과 같은 호스팅이 대안이 될 수 있습니다.

업로드하는 파일의 크기가 큰 경우

업로드하려는 파일의 크기가 서버에서 제한하는 최대 파일 크기를 초과하는 경우 설치/업데이트/업로드가 실패할 수 있습니다.

최대 파일 업로드 크기는 phpinfo 페이지를 만들어 쉽게 확인이 가능합니다. 즉, FTP에 접속하여 루트 폴더에 새 파일을 하나 만들고 다음 코드를 추가합니다.

<?php phpinfo(); ?>

파일 이름을 info.php 파일로 지정합니다(혹은 임의의 원하는 이름으로 지정 가능). 브라우저에 http://www.example.com/info.php를 입력하여 파일 업로드 크기 등을 확인할 수 있습니다.

더 간단한 방법은 워드프레스 관리자 페이지에서 미디어 > 파일 올리기를 클릭하면 업로드 가능한 최대 파일 크기를 확인할 수 있습니다.

파일 업로드 크기 확인

최대 업로드 파일 크기가 너무 작으면 여러 가지 방법으로 이 설정을 늘릴 수 있으며 웹호스팅 업체에 따라 방법이 다를 수 있습니다. 먼저 php.ini 파일에 접근이 가능하면 다음 설정값을 변경하거나 추가합니다.

upload_max_filesize = 64M
post_max_size = 64M
file_uploads = On

php.ini 파일에 접근할 수 없는 경우 .htaccess 파일에 다음 라인을 추가할 수 있습니다.

php_value upload_max_filesize 64M
php_value post_max_size 64M

일부 호스팅에서는 이 설정값을 변경하지 못할 수도 있습니다. 잘 안 되면 웹호스팅 업체에 문의하도록 합니다.

권한 문제

폴더 권한 문제 때문에 파일 업로드가 잘 안 되는 경우가 있습니다. 요즘에는 이런 문제가 거의 없지만, 몇 년 전만 하더라도 일부 호스팅 업체들의 기술이 부족하여 권한(퍼미션; permission) 문제가 종종 발생했습니다.

서버를 직접 운영하는 경우, 이런 문제의 상당수는 잘못된 소유권(privilege) 설정과 관련되어 있습니다. 이 경우 서버 관리자에게 문의하여 권한 설정을 올바르게 수정해달라고 요청해야 합니다.

웹호스팅을 이용하는 경우 폴더의 설정을 755로 설정해야 합니다. 777은 보안상 안전하지 않으므로 권장하지 않습니다. 권한 설정이 의심되면 웹호스팅에 연락하여 상의해보는 것이 좋을 듯 합니다. (직접 서버를 운용하는 경우에는 직접 해결해야 합니다.)

아마존 AWS/라이트세일 등의 VPS 서버에 워드프레스를 설치하여 사용하는 경우, 파일/폴더의 소유권/권한이 잘못되어 이런 문제가 종종 나타납니다. http 소유자 설정이 잘못되는 경우가 있습니다. Ubuntu의 경우 보통 www-data이지만, 서버에 따라 조금씩 다를 수 있습니다. 예를 들어, 다음과 같은 명령어를 통해 폴더의 ownership을 설정해줄 수 있습니다.

sudo chown -R www-data:www-data wordpress/
sudo usermod -a -G www-data www-data

잘 안 되는 경우 서버 관리자에게 연락하여 문제 해결을 시도해보시기 바랍니다. 아마존 서비스의 경우 빠른 속도 때문에 SEO에 유리할 수 있지만, 최적화가 되지 않으면 아마존 AWS에서도 사이트 속도가 느릴 수 있습니다. 그리고 서버에 대한 지식이 없으면 구글링을 통해 문제를 해결하거나 전문가에게 맡겨야 하는데, 이 과정에서 많은 스트레스를 받을 수 있습니다. 이 때문에 아마존 서비스에서 국내 호스팅이나 클라우드웨이즈(Cloudways)와 같은 호스팅으로 이전을 의뢰하는 분들이 계십니다.

실행 시간 초과

max_execution_time 설정 값이 작은 경우에도 워드프레스, 테마, 플러그인의 설치/업데이트가 실패할 수 있습니다. "fatal error: maximum execution time exceeded" 혹은 시간 초과 (타임아웃) 관련 오류 메시지가 표시될 수 있습니다. 이 경우 max_execution_time 설정 값을 높여보시기 바랍니다.

php.ini 파일에 접근이 가능하면 다음 설정을 변경하거나 추가해보십시오.

max_execution_time = 600

php.ini 파일에 접근할 수 없는 경우 .htaccess 파일에 다음 라인을 추가할 수 있습니다.

php_value max_execution_time 600

사이트그라운드의 경우 다음 글을 참고해보세요.

호스팅에 따라 이 설정을 변경하지 못할 수도 있습니다.

플러그인 충돌 문제

플러그인 충돌 때문에 이와 같은 문제가 발생하는 경우가 있습니다. 모든 플러그인을 비활성화한 후에도 문제가 발생하는지 확인해보시기 바랍니다.

문제를 일으키는 플러그인을 찾으면 삭제하고, 비슷한 기능의 다른 플러그인으로 대체하는 것은 좋습니다.

문제가 해결되지 않는 경우

여러 가지 조치에도 문제가 해결되지 않으면, (서버 공간이 충분하다면) 임시로 FTP를 통해 워드프레스 설치 파일을 업로드할 수 있습니다. FTP 사용법은 여기를 참고해보세요. 하지만 FTP/sFTP를 통해 파일을 업로드할 때 permission denied(퍼미션 거부)와 같은 권한 문제가 발생한다면, 먼저 권한 문제를 해결해야 합니다.

마치며

이상으로 워드프레스, 테마, 플러그인의 설치나 업데이트가 실패하는 문제가 발생하는 경우에 대처할 수 있는 방법에 대해 살펴보았습니다.

여러 가지 조치에도 불구하고 문제가 잘 해결되지 않으면 여기에서 유료 서비스를 의뢰할 수 있습니다.

참고


6개 댓글

  1. 저도 똑같은 현상을 겪고 있는데 카페24에서 확인을 하니까 전체 용량 200M중에 12M가 남고 웹트래픽 용량 600M 중에 35M 가 남았는데.. 이 경우도 해당이 될까요? 만약 그렇다면 전체 용량을 추가해야 하나요?

    1. 특히 용량이 부족하여 이 문제가 발생하는 경우가 많습니다.

      웹호스팅 서버의 용량이 부족하면 테마, 플러그인 설치나 업데이트가 안 될 뿐만 아니라, 글이나 페이지 편집 시에도 저장이 안 되거나 페이지 빌더가 제대로 작동하지 않는 등의 이상한 문제가 발생하고, 자동 복원 기능을 제공하는 웹호스팅에서는 자동 복원 과정에서 오류가 발생하여 낭패를 볼 수 있습니다.

댓글 남기기

* 이메일 주소는 공개되지 않습니다.