WP Rocket 플러그인 워드프레스 7.1에서 치명적인 오류 발생 및 해결 방법

지난 8월 19일(우리나라 시각으로 8월 20일 새벽) 워드프레스 7.1이 공개되었습니다. 워드프레스 7.1 환경에서 WP Rocket이 치명적인 오류를 일으키는 문제가 발생하고 있습니다. 이 오류는 WP Rocket v3.23.2.2 버전에서 수정되었습니다. WP Rocket 플러그인을 사용하고 있다면 먼저 플러그인을 최신 버전으로 업데이트한 후에 워드프레스 7.1로 업데이트하는 것이 안전합니다. 만약 WP Rocket 때문에 치명적인 오류가 발생하고 있다면 FTP/SFTP에 접속하여 /wp-content/plugins/wp-rocket/ 폴더를 임시로 다른 이름을 변경(예: /wp-content/plugins/wp-rocket-off/)하면 사이트가 정상화될 것입니다. 사이트 접속이 가능해지면 관리자 페이지에 로그인하여 WP Rocket을 최신 버전으로 업데이트하시기 바랍니다.

WP Rocket 플러그인 워드프레스 7.1에서 치명적인 오류 발생

보안을 위해 워드프레스, 테마, 플러그인을 항상 최신 버전으로 업데이트하는 것이 바람직합니다. 하지만 드물지만 업데이트 후에 사이트 에러가 발생하는 경우가 있습니다. 그러므로 중요한 사이트라면 곧바로 업데이트하지 말고 며칠 정도 지켜본 후에 업데이트하는 것도 괜찮은 방법입니다. 또한, 중요한 사이트인 경우 백업을 확실히 한 후에 업데이트하는 것이 좋습니다.

카페24나 클라우드웨이즈, 케미클라우드 등은 롤백하는 기능이 제공되므로 업데이트 후에 사이트에 치명적인 오류가 발생할 경우 어제 날짜로 되돌리는 것이 가능합니다.

저는 어제 관리하는 모든 사이트를 워드프레스 7.1 버전으로 업데이트했습니다. 다행히 오류가 발생하는 사이트는 없었습니다.

하지만 일부 WP Rocket 사용자들이 워드프레스 7.1로 업데이트했다가 치명적인 오류 문제가 발생하는 경험을 했을 수도 있습니다. 새로운 워드프레스 버전이 공개되면 워드프레스 코어에 앞서 테마나 플러그인을 먼저 업데이트하는 것이 좋습니다. 새로운 워드프레스 버전에서 치명적인 오류가 발생하는 문제가 발생할 수 있기 때문입니다. 최신 워프 버전에서 치명적인 오류가 발생할 경우 인기 플러그인들은 대부분 빠르게 대처하여 패치된 버전을 내놓을 가능성이 높습니다.

WP Rocket 구버전이 설치된 상황에서 워드프레스 7.1로 업데이트하면 사이트에 치명적인 오류가 발생합니다.

다음과 같은 에러 로그가 표시될 수 있습니다.

An error of type E_ERROR was caused in line 562 of the file .../wp-content/plugins/wp-rocket/inc/ThirdParty/Plugins/CDN/Cloudflare.php.

Error message: Uncaught TypeError: substr() expects parameter 1 to be string, int given in .../wp-content/plugins/wp-rocket/inc/ThirdParty/Plugins/CDN/Cloudflare.php:562

PHP Fatal error:  Uncaught TypeError: substr(): Argument #1 ($string) must be of type string,
int given in .../wp-content/plugins/wp-rocket/inc/ThirdParty/Plugins/CDN/Cloudflare.php:562

Uncaught TypeError: substr(): Argument #1 ($string) must be of type string, int given in .../wp-content/plugins/wp-rocket/inc/ThirdParty/Plugins/CDN/Cloudflare.php:562

이와 같은 오류가 발생하면 FTP/SFTP에 접속하여 wp rocket 플러그인 폴더 이름을 변경(예: /wp-content/plugins/wp-rocket/ 폴더 이름을 /wp-content/plugins/wp-rocket-off/로 변경)하면 사이트 오류가 사라질 것입니다. 사이트 오류가 사라지면 워드프레스 알림판에 접속하여 WP Rocket 플러그인을 삭제하고 WP Rocket 사이트에서 최신 버전을 다운로드하여 최신 버전을 설치할 수 있습니다.

오류의 원인에 대한 자세한 정보는 Fatal TypeError: substr() Argument #1 must be of type string, int given in Cloudflare.php on line 562 글을 참고할 수 있습니다.  이 GitHub 포스트의 내용을 요약하면 다음과 같습니다.

워드프레스 7.1 업데이트 이후, WP Rocket 플러그인 사용 환경에서 TypeError: substr() 치명적 오류(Fatal Error)가 발생하며 웹사이트의 프론트엔드와 관리자 페이지가 모두 다운되는(White Screen of Death) 현상입니다.

발생 원인

• 데이터 타입 불일치: 워드프레스 7.1에서 콜백 ID를 생성하는 방식이 변경되어, 배열의 키(key) 값으로 문자열(string)이 아닌 숫자(int)가 반환되는 경우가 생겼습니다. (예: 엘리멘터 등 특정 플러그인이 훅을 등록할 때 발생)
• WP Rocket의 예외 처리 누락: WP Rocket의 클라우드플레어 연동 파일(Cloudflare.php)에서는 해당 키 값을 무조건 문자열이라 가정하고 substr() 함수에 그대로 전달했습니다.
• PHP 8의 엄격한 기준: 이로 인해 엄격한 타입 검사를 하는 PHP 8 이상의 환경에서, 문자열이 들어가야 할 자리에 숫자가 들어갔다며 치명적 오류를 뱉어냈습니다.

영향 및 심각성

• 실제 클라우드플레어 기능 사용 여부와 관계없이 WP Rocket이 활성화되어 있으면 관련 코드가 무조건 실행되어 사이트를 마비시켰습니다.
• 7월에 이미 보고된 버그였으나 제대로 조치되지 않은 상태에서 워드프레스 7.1 자동 업데이트가 진행되며 수많은 상용 사이트가 동시에 접속 불가 상태에 빠졌습니다.

해결 방법

1. 플러그인 업데이트 (권장): WP Rocket 측에서 긴급 배포한 핫픽스 버전인 3.23.2.2로 업데이트하면 해결됩니다.
2. 임시 코드 수정: 당장 관리자 페이지 접속이나 업데이트가 불가능한 경우, 에러가 발생하는 562번째 줄의 $key 변수 앞에 (string)을 추가해 문자열로 강제 변환해 주면 임시로 사이트를 복구할 수 있습니다.

// 수정 전
if ( substr( $key, - strlen( $method ) ) !== $method ) {
	continue;
}

// 수정 후 (형변환 적용)
if ( substr( (string) $key, - strlen( $method ) ) !== $method ) {
	continue;
}

만약 최신 WP Rocket 버전으로 업데이트할 수 없는 상황이라면 임시로 코드를 수정하는 방법으로 문제 해결을 시도해볼 수 있습니다.

또는, 유료 워드프레스 캐시 플러그인인 WP Rocket 대신 LiteSpeed Cache와 같은 무료 캐싱 플러그인 사용도 고려해 볼 수 있습니다. 저는 Breeze 캐시 플러그인을 모든 사이트에 사용하고 있습니다. 클라우드웨이즈(Cloudways)를 이용하고 있다면 굳이 유료 캐시 플러그인 대신 무료로 제공되는 Breeze Cache 플러그인을 사용하는 것도 괜찮습니다.

워드프레스 Breeze 캐시 플러그인 설정 방법 - 워드프레스 정보꾸러미

FTP 접속 방법을 모르는 경우 이용하는 웹호스팅 업체에 문의하여 안내를 받을 수 있습니다.

👉 워드프레스나 웹호스팅 관련 문제로 해결에 어려움을 겪는 경우 여기에서 서비스(유료)를 의뢰하실 수 있습니다.😀

마치며

이상으로 워드프레스 7.1에서 WP Rocket의 치명적인 오류에 대해 살펴보았습니다. 새로운 워드프레스 버전이 출시될 경우 중요한 사이트(예: 쇼핑몰, 인강 사이트)라면 곧바로 업데이트하지 말고 며칠 지켜 본 후에 업데이트하는 것도 오류를 피할 수 있는 방법 중 하나입니다. 빨리 업데이트하기를 원하는 경우에는 테스트 사이트나 스테이징 사이트를 만들어 먼저 업데이트 테스트를 한 후에 실 사이트에 적용하는 것도 생각할 수 있습니다.

저처럼 블로그를 운용한다면 보통 곧바로 업데이트해도 큰 문제는 없을 것입니다. 문제가 발생하면 웹호스팅에서 롤백(복원) 기능을 제공하는지 체크해보시기 바랍니다.

참고

https://avada.tistory.com/3954

워드프레스 7.0 업데이트 후 사이트 오류 발생 시 해결 방법 (+Quform 컨택트 폼 에러)

https://avada.tistory.com/3046

해외웹호스팅: 클라우드웨이즈 vs. 블루호스트 vs. 카페24 비교 (Cloudways vs. Bluehost vs. Cafe24)