워드프레스 Yoast SEO 플러그인 업데이트 후 오류 발생 시 해결 방법

어제 인기 워드프레스 SEO 플러그인인 Yoast SEO가 어제 19.5.1 버전으로 업데이트되었습니다. 업데이트 후에 사이트 에러가 발생한다는 분들이 계십니다. 다음 버전에서 에러가 해결될 것 같습니다. Yoast SEO 플러그인 업데이트 때문에 사이트에 문제가 발생한 경우 패치가 나오기 전까지 아래의 조치를 취할 수 있습니다.

아래의 방법은 다른 플러그인을 업데이트한 후에 오류가 발생하는 경우에도 적용할 수 있습니다.

워드프레스 Yoast SEO 플러그인 업데이트 후 오류 발생 시 해결 방법

Yoast SEO 플러그인 업데이트 후 위의 그림과 비슷한 오류가 발생한다고 호소하는 분들이 계십니다.

Fatal error: Uncaught YoastSEO_Vendor\Symfony\Component\DependencyInjection\Exception\ServiceNotFoundException: You have requested a non-existent service "Yoast\WP\SEO\Conditionals\Front_End_Inspector_Conditional". Did you mean one of these: "Yoast\WP\SEO\Conditionals\Addon_Installation_Conditional", "Yoast\WP\SEO\Conditionals\Admin\Licenses_Page_Conditional", "Yoast\WP\SEO\Conditionals\Admin\Post_Conditional", "Yoast\WP\SEO\Conditionals\Admin_Conditional", "Yoast\WP\SEO\Conditionals\Development_Conditional", "Yoast\WP\SEO\Conditionals\Front_End_Conditional", "Yoast\WP\SEO\Conditionals\Get_Request_Conditional", "Yoast\WP\SEO\Conditionals\Import_Tool_Selected_Conditional", "Yoast\WP\SEO\Conditionals\Jetpack_Conditional", "Yoast\WP\SEO\Conditionals\Migrations_Conditional", "Yoast\WP\SEO\Conditionals\New_Settings_Ui_Conditional", "Yoast\WP\SEO\Conditionals\News_Conditional", "Yoast\WP\SEO\Conditionals\No_Tool_Selected_Conditional", "Yoast\WP\SEO\Conditionals\Non_Multisite_Conditional", "Yoast\WP\SEO\Conditionals\Not_Admin_Aj in /home/customer/www/eventtia.com/public_html/wp-content/plugins/wordpress-seo/vendor_prefixed/symfony/dependency-injection/Container.php on line 307

이 경우 아래의 방법으로 사이트 복구를 시도해보시기 바랍니다.

사이트 롤백하기

업데이트하기 전에 백업한 백업본이 있다면 백업 파일을 사용하여 사이트를 롤백하시기 바랍니다. 백업본이 없다면 웹호스팅에 문의하면 백업본을 유지할 수도 있습니다.

이 방법을 이용하여 쉽게 사이트를 정상화할 수 있습니다.

오류가 패치된 Yoast SEO 업데이트 버전이 릴리스되면 업데이트할 수 있습니다.

플러그인 삭제하기

오류로 인해 사이트가 접속 불능인 경우 문제가 되는 플러그인(이 경우 Yoast SEO)을 비활성화할 수 없습니다. 이 경우 FTP에 접속하여 [**/wp-content/plugins/wordpress-seo**] 폴더를 삭제하면 Yoast SEO가 삭제되면서 사이트가 정상화될 것입니다.

이 작업은 FTP를 통해 접속해도 되고, 블루호스트 등 cPanel이 제공되는 환경에서는 File Manager를 사용하여 웹서버에 접속한 후 해당 폴더를 삭제해도 됩니다.

https://avada.tistory.com/1571

블루호스트에서 파일 관리자 (File Manager) 사용하기

사이트가 정상화되면 새로운 패치가 나올 때까지 기다렸다가 업데이트가 공개되면 다시 알림판에서 Yoast SEO 플러그인을 설치하면 됩니다.

당장 Yoast SEO를 사용해야 하는 경우라면 이전 버전을 다운로드하여 설치할 수 있습니다. 하지만 며칠 Yoast SEO 플러그인을 비활성화한다고 해서 사이트에 문제가 나타나지는 않을 것입니다.

Autoptimize와의 충돌 문제

Autoptimize 플러그인이 설치된 경우 Yoast SEO 플러그인 업데이트 시에 충돌이 발생할 수 있습니다. 이 경우 다음 JS 파일을 제외하도록 설정하면 문제가 해결된다고 합니다.

/wp-content/plugins/wordpress-seo, /wp-content/plugins/wordpress-seo-premium

저는 Autoptimize 대신 Clearfy라는 최적화 플러그인을 사용하고 있습니다.

https://avada.tistory.com/2513

워드프레스 사이트 속도 향상을 위한 Clearfy 플러그인 세팅 예시

마치며

드물지만 워드프레스 코어, 테마 혹은 플러그인을 업데이트한 후에 플러그인 충돌 등으로 인해 사이트에 문제가 발생하는 경우가 있습니다.

업데이트 전에는 사이트를 백업하는 것이 안전합니다. 하지만 플러그인을 업데이트할 때마다 백업하는 것은 매우 번거로울 수 있습니다. 업데이트 후에 사이트에 에러가 발생하는 경우 위의 방법을 참고하여 사이트를 복구할 수 있습니다. 정기적으로 사이트를 백업하면 사이트 접속 문제가 발생할 때 쉽게 복원이 가능합니다.

참고

효과적인 글쓰기를 위한 Rank Math 활용 방법 (SEO 글쓰기) - 워드프레스 정보꾸러미

https://avada.tistory.com/2391

워드프레스 GeneratePress 테마에서 Yoast SEO 브레드크럼 적용하기