W3 Total Cache 설치 오류 해결 방법 – 라이트세일 권한 문제 수정하기

W3 Total Cache 설치 오류는 AWS Lightsail 환경에서 자주 만나는 문제 중 하나입니다. 플러그인 설치 자체는 정상적으로 끝나지만 캐시 기능을 활성화하는 과정에서 갑자기 오류 메시지가 나타나는 경우가 있습니다.

저 역시 처음에는 플러그인 충돌이나 워드프레스 오류를 의심했지만 내용을 자세히 살펴보니 서버 권한 문제였습니다. 특히 Bitnami 기반 라이트세일 서버는 일반 호스팅 환경과 권한 구조가 다르기 때문에 W3 Total Cache 설치 오류가 발생하는 경우가 적지 않습니다.

플러그인이 수정해야 할 파일을 직접 생성하지 못하면서 경고가 표시된 것이었습니다.

오류 메시지에서 먼저 확인한 부분

설치를 마친 뒤 플러그인 화면 상단에 빨간색 경고 박스가 나타났습니다. FTP 권한 문제와 함께 파일 생성에 실패했다는 내용이 표시되었고, 아래쪽에는 해결 방법을 확인할 수 있는 버튼이 함께 보였습니다.

워드프레스 관리자 화면에서 W3 Total Cache 설치 오류가 나타난 모습 — W3 Total Cache 설치 후 표시된 권한 오류

당시에는 직접 파일을 만들어야 하는 줄 알았지만 플러그인이 이미 해결 방법을 안내하고 있었습니다.

View Required Changes에서 해결 방법 확인

오류 화면의 View Required Changes를 열어보면 플러그인이 필요한 작업을 자동으로 알려줍니다. 필요한 파일 복사 명령어 또는 권한 변경 명령어가 표시되기 때문에 복잡하게 검색할 필요가 없었습니다.

W3 Total Cache가 수정해야 할 파일 생성 명령어를 표시하는 화면 — 필요한 서버 명령어 확인 화면

여기서 표시되는 명령어는 서버 환경마다 다를 수 있기 때문에 화면에 나온 내용을 그대로 사용하는 것이 가장 안전합니다.

SSH에서 명령어 실행

라이트세일 브라우저 SSH 또는 터미널 접속 후 표시된 명령어를 그대로 입력했습니다. 플러그인이 생성하지 못했던 object-cache.php 파일을 직접 복사하는 방식이었습니다.

Bitnami SSH 터미널에서 W3 Total Cache 명령어를 실행하는 모습 — SSH에서 파일 생성 명령어 실행

명령어 실행 후 별다른 오류 메시지가 나오지 않았고, 관리자 화면을 새로 고치자 일부 경고가 사라졌습니다.

W3 Total Cache 설치 오류의 원인

대부분의 W3 Total Cache 설치 오류는 파일 권한과 관련되어 있습니다.

플러그인이 wp-content 내부 파일을 생성하거나 수정하려고 시도하지만 서버 권한이 부족하면 작업이 중단됩니다.

특히 아래 상황에서 자주 발생합니다.

object-cache.php 생성 실패
advanced-cache.php 생성 실패
wp-config.php 수정 실패
캐시 폴더 생성 실패
FTP 자격 증명 오류

Bitnami 환경에서는 보안상 제한이 적용되어 있어 일반 공유 호스팅보다 이러한 문제가 더 자주 발생합니다.

파일 권한 수정으로 해결한 과정

명령어 실행 후에도 일부 경고가 남아 있는 경우에는 권한을 확인해야 합니다. 파일은 보통 644, 폴더는 755 권한을 사용합니다.

예를 들면 다음과 같은 형태입니다.

sudo chmod 644 파일경로

sudo chmod 755 폴더경로

수정 후 Apache 또는 웹 서버를 다시 시작하면 반영됩니다.

sudo /opt/bitnami/ctlscript.sh restart apache

OpenLiteSpeed 환경에서는 Apache 재시작 대신 WebAdmin 또는 CyberPanel에서 서비스를 다시 시작하는 방식으로 처리할 수 있습니다.

적용 후 달라진 점

권한 수정과 파일 생성을 마친 뒤 관리자 화면의 경고 메시지가 사라졌습니다. Page Cache, Browser Cache, Object Cache 설정도 정상적으로 저장되기 시작했고 캐시 파일 생성 역시 문제없이 진행되었습니다.

며칠 동안 테스트한 결과 추가 오류는 발생하지 않았으며 GTmetrix와 PageSpeed 측정 시 캐시 관련 기능도 정상적으로 동작했습니다. 워드프레스에서 발생하는 많은 플러그인 오류가 실제로는 서버 권한 문제인 경우가 많다는 점을 다시 확인할 수 있었습니다.

FAQ

W3 Total Cache 설치 오류가 계속 발생합니다.

오류 메시지 안에 표시된 View Required Changes 내용을 먼저 확인하는 것이 좋습니다. 대부분 필요한 명령어가 함께 표시됩니다.

W3 Total Cache 설치 오류는 OpenLiteSpeed에서도 발생하나요?

발생할 수 있습니다. 다만 OpenLiteSpeed 환경에서는 LiteSpeed Cache를 사용하는 경우가 많기 때문에 W3 Total Cache 사용 빈도는 상대적으로 적습니다.

FTP 자격 증명 오류도 같은 원인인가요?

대부분 파일 또는 폴더 권한 문제로 발생합니다. 서버 권한을 수정하면 해결되는 경우가 많습니다.