워드프레스 치명적인 오류 해결 작업

케미클라우드에서 운영 중인 워드프레스 사이트에서 치명적인 오류가 발생하여 문제 해결 작업을 맡았습니다. 오랫동안 관리하지 않고 방치하면서 워드프레스와 일부 플러그인은 자동 업데이트가 되었지만, 일부는 자동 업데이트가 안 되면서 플러그인 충돌로 인해 사이트에 치명적인 오류가 발생하고 있었습니다.

워드프레스 사이트에서 치명적인 오류 문제 해결 작업

워드프레스 사이트에서 치명적인 오류가 발생하는 경우 먼저 오류 로그를 체크하여 원인을 파악하면 빠르게 문제를 해결할 수 있습니다.

디버그 모드를 활성화하여 에러 로그를 체크해보니 다음과 같은 오류가 발생하고 있었습니다.

[15-Jan-2026 01:47:56 UTC] PHP Fatal error:  Uncaught Error: Call to undefined function WPDM\__\wp_generate_password() in /home/public_html/wp-content/plugins/download-manager/src/__/Session.php:59
Stack trace:
#0 /home/public_html/wp-content/plugins/download-manager/src/__/Session.php(28): WPDM\__\Session::initDeviceID()
#1 /home/public_html/wp-content/plugins/download-manager/src/__/Session.php(41): WPDM\__\Session::init()
#2 /home/public_html/wp-content/plugins/download-manager/download-manager.php(181): WPDM\__\Session->__construct()
#3 /home/public_html/wp-content/plugins/download-manager/download-manager.php(151): WPDM\WordPressDownloadManager->__construct()
#4 /home/public_html/wp-content/plugins/download-manager/download-manager.php(547): WPDM\WordPressDownloadManager::instance()
#5 /home/public_html/wp-settings.php(560): include_once('/home/...')
#6 /home/public_html/wp-config.php(102): require_once('/home/...')
#7 /home/public_html/wp-load.php(50): require_once('/home/...')
#8 /home/public_html/wp-blog-header.php(13): require_once('/home/...')
#9 /home/public_html/index.php(17): require('/home/...')
#10 {main}
  thrown in /home/public_html/wp-content/plugins/download-manager/src/__/Session.php on line 59

Download Manager 플러그인 때문에 사이트에 치명적인 오류가 발생하고 있었습니다.

다운로드 매니저는 워드프레스 사이트에서 파일·문서 다운로드를 체계적으로 관리하고 제어할 수 있는 파일 관리/다운로드 플러그인으로, 드래그 앤 드롭 업로드와 커스텀 포스트 타입을 통해 게시글 쓰듯 다운로드 항목을 만들고, 비밀번호·회원 역할·카테고리 단위 접근 제어·다운로드 속도 제한·다운로드 횟수 제한·IP 차단·캡차 잠금·약관 동의 등의 기능으로 보안과 권한을 세밀하게 설정하며, 통합 로그와 통계를 통해 누가 언제 어디서 어떤 파일을 받았는지 추적할 수 있고, 추가로 Google Drive·Dropbox·OneDrive 등 클라우드 저장소 연동과 전용 쇼트코드·위젯·사용자 대시보드, 그리고 무료 애드온/프리미엄 애드온을 활용하면 디지털 상품 판매용 간단한 이커머스/마켓플레이스까지 구축할 수 있는 것이 특징입니다.

이 플러그인은 많은 기능을 제공하다 보니 플러그인을 설치하여 테스트해보니 사이트 속도에 영향을 미치는 것 같습니다. 꼭 필요한 경우라면 설치하면 편리하겠지만, 그렇지 않다면 다른 방법으로 파일을 다운로드하도록 하는 것을 고려할 수 있습니다. 예를 들어, 네이버 카페를 이용하거나 티스토리 블로그에서 파일을 다운로드하도록 하는 것도 하나의 방법일 수 있습니다.

해당 플러그인을 삭제한 후에 최신 버전으로 업데이트하니 문제가 해결되었습니다. 혹시 몰라서 모든 플러그인과 테마를 최신 버전으로 업데이트하고 PHP 버전도 조금 낮아서 PHP 8.3으로 업그레이드했습니다.

케미클라우드에서는 PHP 5.6 버전에서 PHP 8.4 버전 사이에서 PHP 버전을 선택할 수 있습니다. 가급적 PHP 8.3이나 PHP 8.4를 선택하는 것이 바람직합니다. PHP 8.4가 최신 버전이기 때문에 속도와 보안 등의 측면에서 바람직하지만, 간혹 호환되지 않는 테마나 플러그인이 있을 수 있습니다. 그런 경우에는 PHP 버전을 8.3이나 8.2 등 문제가 발생하지 않는 버전으로 낮추어서 대응할 수 있습니다.

실제로 다국어 플러그인인 WPML을 사용하는 환경에서 에러가 발생하여 PHP 버전을 8.0으로 낮추니 문제가 해결되었다고 하는 사용자도 있네요. (WPML은 최신 PHP 버전에서 잘 작동하는 것으로 보이지만, 다른 테마나 플러그인과의 충돌로 인해 제대로 작동하지 않는 경우 PHP 버전을 낮추어서 문제가 해결되는지 테스트해볼 수 있습니다.)

오류 로그에서 명확한 오류 메시지가 표시되면 해결이 쉬울 수 있지만, 가끔 오류 로그에 아무런 에러 메시지가 표시가 안 되는 경우가 있습니다. 그런 경우에는 문제의 원인을 파악하는 것이 어려울 수 있습니다.

워드프레스 블로그를 운영하는 경우 가급적 워드프레스 코어와 테마와 플러그인을 모두 최신 상태로 업데이트하는 것이 보안상 안전합니다.

워드프레스 블로그인 경우 테마와 플러그인들이 자동 업데이트되도록 설정하면 업데이트가 있을 때 자동으로 업데이트가 됩니다. 다만, 유료 플러그인은 일반적으로 자동 업데이트가 되지 않으므로 업데이트가 나오면 업데이트 버튼을 눌러 업데이트해야 합니다.