워드프레스 플러그인 설치실패 오류 원인?
워드프레스 플러그인 설치실패 오류 원인?
최근 워드프레스(WP)를 사용하다 보면, 플러그인, 테마 또는 코어 업데이트 및 설치 시 "설치 실패" 오류가 발생하는 경우가 많습니다.
✅ 대표적인 오류 메시지 예시
- "Your browser sent a request that this server could not understand."
- "업로드된 파일이 wp-content/uploads/... 로 옮겨질 수 없습니다."
- "디렉터리를 생성할 수 없습니다. 설치 실패."
이러한 오류는 서버 설정 문제, 파일 업로드 제한, 권한 오류, 실행 시간 초과, 플러그인 충돌 등의 다양한 원인에 의해 발생할 수 있는데요 이에 대해서 워드프레스 플러그인 설치 실패 오류의 주요 원인과 해결 방법을 자세히 정리하여, 누구나 쉽게 문제를 해결할 수 있도록 도와드리겠습니다.
🔹 워드프레스 플러그인 설치 실패 원인 및 해결 방법
1️⃣ 웹호스팅 서버의 디스크 공간 부족
🔹 원인
- 웹호스팅에서 제공하는 디스크 공간이 부족하면 워드프레스에서 플러그인, 테마, 업데이트 설치가 정상적으로 진행되지 않음
- 특히 **저가형 웹호스팅(예: 카페24, 닷홈 무료 호스팅)**을 사용하는 경우, 용량이 빨리 소진될 수 있음
✅ 해결 방법
- 웹호스팅 관리자 페이지에서 디스크 사용량 확인
- 카페24: "호스팅 관리 → 사용량 모니터링"
- 디스크 공간이 부족하다면?
- 불필요한 파일(미사용 플러그인, 테마, 백업 파일 등) 삭제
- 웹호스팅 업그레이드 고려 (예: 클라우드웨이즈, 패스트코멧, 케미클라우드)
2️⃣ 업로드 파일 크기 제한 문제
🔹 원인
- 웹호스팅에서 허용하는 최대 파일 업로드 크기를 초과할 경우, 플러그인 설치 실패 가능성이 높음
✅ 해결 방법
📌 최대 파일 업로드 크기 확인 방법
FTP에 접속하여 루트 폴더에 info.php 파일을 생성 후 아래 코드를 추가한 후 저장합니다.
<?php phpinfo(); ?>http://www.example.com/info.php로 접속하여 "upload_max_filesize" 값 확인
📌 업로드 파일 크기 제한 변경 방법
(웹호스팅 환경에 따라 아래 방법 중 하나를 선택)
🔹 방법 1: php.ini 파일 수정
upload_max_filesize = 64M
post_max_size = 64M
file_uploads = On🔹 방법 2: .htaccess 파일 수정
php_value upload_max_filesize 64M
php_value post_max_size 64M🔹 방법 3: functions.php 파일 추가 코드
@ini_set( 'upload_max_size' , '64M' );
@ini_set( 'post_max_size', '64M');
@ini_set( 'max_execution_time', '300' );⚠ 주의: 일부 웹호스팅(예: 닷홈, 카페24)에서는 위 설정을 변경할 수 없을 수도 있음. 이 경우 웹호스팅 고객센터에 문의하여 설정 변경 요청 필요합니다.
3️⃣ 권한(Permission) 문제
🔹 원인
- wp-content, wp-content/plugins 등의 디렉터리에 적절한 쓰기/읽기 권한이 설정되지 않음
- 서버에서 파일 소유자(Ownership) 설정 오류
✅ 해결 방법
🔹 FTP(파일질라) 또는 SSH로 접근하여 권한 수정
- wp-content/plugins 디렉터리 → "파일 권한 변경"
- 권한을 755로 설정 (777은 보안상 위험)
🔹 서버 소유권 문제 해결 (VPS 서버 사용 시)
sudo chown -R www-data:www-data /var/www/html/wordpress/
sudo chmod -R 755 /var/www/html/wordpress/⚠ 참고: AWS 라이트세일, 우분투(Ubuntu) 기반 서버에서는 기본적으로 www-data가 소유자이며, 이를 올바르게 설정해야 오류 해결 가능
4️⃣ 실행 시간 초과 (max_execution_time 초과 오류)
🔹 원인
- 플러그인 설치 중 시간이 오래 걸릴 경우, 서버가 실행을 중단하며 오류 발생
- 보통 Fatal error: Maximum execution time exceeded 메시지 출력됨
✅ 해결 방법
📌 php.ini 파일 수정 (최대 실행 시간 연장)
max_execution_time = 600📌 .htaccess 파일 수정
php_value max_execution_time 600📌 wp-config.php 파일 수정
set_time_limit(600);⚠ 주의: 일부 웹호스팅에서는 이 값을 직접 변경할 수 없으므로, 고객센터에 요청 필요
5️⃣ 플러그인 충돌 문제
🔹 원인
- 특정 플러그인이 워드프레스 시스템 또는 다른 플러그인과 충돌하여 설치가 중단됨
✅ 해결 방법
📌 모든 플러그인 비활성화 후, 설치 시도
- 워드프레스 관리자 페이지 → 플러그인 → 설치된 플러그인
- 모든 플러그인 비활성화 후 문제 플러그인 설치 시도
- 정상적으로 설치되면, 하나씩 다시 활성화하여 충돌 원인 플러그인 찾기
참고 : 워드프레스 플러그인 설치 - 설치 안될때 강제설치
📌 테마 충돌 가능성 체크
- 테마 충돌이 의심되면, 기본 테마(예: Twenty Twenty-One)로 변경 후 설치 시도
🔹 해결되지 않는 경우 FTP를 이용한 수동 설치
✅ FTP를 이용하여 플러그인 수동 설치 방법
- https://wordpress.org/plugins/에서 플러그인 ZIP 파일 다운로드
- FTP(SFTP)로 wp-content/plugins/ 경로에 접속
- 압축 해제 후, 해당 폴더를 직접 업로드
- 워드프레스 관리자에서 플러그인 활성화
⚠ 만약 FTP 업로드 시 "permission denied" 오류 발생 시, 위의 "권한 문제 해결" 방법을 적용
이상 워드프레스 플러그인 설치 실패 오류는 디스크 공간 부족, 파일 크기 제한, 권한 문제, 실행 시간 초과, 플러그인 충돌 등의 원인에 의해 발생합니다.
📌 해결 방법 요약
✅ 디스크 공간 확인 후 부족하면 확장 또는 불필요한 파일 정리
✅ 파일 크기 제한 설정 변경(upload_max_filesize, post_max_size 등)
✅ 폴더 권한 755로 설정 및 서버 소유권 문제 해결
✅ max_execution_time 설정 변경하여 실행 시간 연장
✅ 플러그인 충돌 문제 해결을 위해 모든 플러그인 비활성화 후 테스트
✅ 문제가 지속되면 FTP를 통한 플러그인 수동 설치 진행
🚀 이제 워드프레스 플러그인을 원활하게 설치하고 사용하세요! 😊