워드프레스에서 TranslatePress 플러그인을 사용하여 다국어 사이트를 구축할 때 "TranslatePress encountered SQL errors" 에러가 발생하는 경우가 있습니다. 특히 이 문제는 워드프레스 사이트를 이전(마이그레이션)한 후에 발생할 수 있습니다.

워드프레스 "TranslatePress encountered SQL errors" 에러가 발생하는 경우
워드프레스 다국어 사이트를 운영하려는 경우 TranslatePress, WPML과 같은 플러그인을 상요할 수 있습니다. TranslatePress는 실시간 번역이 가능한 직관적인 프론트엔드 인터페이스를 제공하며, 간편한 사용법으로 초보자나 소규모 웹사이트에 적합합니다. 또한, 무료 버전을 제공하여 예산이 한정된 사용자에게 매력적인 선택일 수 있습니다.
WPML은 TranslatePress에 비해 조금 복잡할 수 있지만 강력한 다국어 지원 기능을 갖추고 있습니다. 고급 SEO 기능, 전자상거래 통합, 전문 번역 관리 시스템을 통해 대규모 웹사이트나 복잡한 다국어 요구를 가진 비즈니스에 적합합니다. 또한, 전문 번역 서비스와 자동 번역기와의 통합과 세부적인 번역 워크플로우 관리를 지원합니다.
아바다 등 대부분의 인기 테마는 WPML과의 호환성을 표시할 만큼 WPML은 다국어 사이트 구축에 많이 이용되고 있습니다.
클라이언트께서 카페24로 워드프레스 사이트를 이전한 후에 속도가 느려지는 문제로 클라우드웨이즈 등 해외 서버로 이전하는 작업 문의를 해오셔서 관리자 페이지에 접속하여 살펴보니 "TranslatePress encountered SQL errors" 에러가 발생하고 있었습니다.
하지만 사이트 속도가 느린 이유는 이 때문은 아닌 것 같았습니다. 사이트에 무거운 플러그인이 제법 설치되어 있었고 플러그인도 많아서 전세 사이트 속도고 매우 느린 상태였습니다.

참고로 사이트 속도가 중요하다면 엘리멘터와 같은 플러그인을 사용하지 않는 것이 바람직할 수 있습니다. 엘리멘터가 페이지 빌더 중에서 속도가 빠른 편이지만 사이트 속도에 어느 정도 영향을 미칠 수밖에 없습니다.
하지만 엘리멘터를 사용하면 디자인 작업 시간을 크게 줄일 수 있고 초보자도 쉽게 사이트를 만들 수 있어 많이 이용되고 있습니다. 속도가 마음에 안 드는 경우 캐시 플러그인과 최적화 플러그인을 설치하여 세팅하면 속도가 어느 정도 향상될 수 있습니다.
TranslatePress에서 SQL 에러가 발생하는 문제가 발생할 경우 Check out the errors를 클릭하여 제시된 문제 해결 방법을 시도해볼 수 있습니다.
워드프레스 관리자 페이지 » 설정 » TranslatePress » General 탭에서 저장 버튼을 클릭하면 현재 SQL 설정을 사용하여 DB 테이블이 새로 생성됩니다.

먼저 이 조치로 문제가 해결되는지 확인해보시기 바랍니다.
위의 방법으로 문제가 해결되지 않으면 TranslatePress 플러그인이 최신 버전인지 확인하여 최신 버전이 아니면 최신 버전으로 업데이트하여 문제가 해결되는지 체크할 수 있습니다.
실제로 문제가 발생하는 사이트를 확인해보니 플러그인 버전이 최신 상태가 아니었습니다.

2024년 12월 19일 현재 TranslatePress의 최신 버전은 2.9.3이지만 사이트에 설치된 플러그인은 2.6.1이었습니다.
사이트를 살펴보니 워드프레스 버전은 6.7.1로 최신 버전이었지만 엘리멘터, TranslatePress, 우커머스 등 대부분의 플러그인 버전은 최신 버전이 아니었습니다. 아마 사이트를 이전하면서 테마와 플러그인은 기존 버전을 그대로 유지되었지만 워드프레스 버전만 최신 버전으로 변경되면서 문제가 되고 있는 것으로 보였습니다.
요약하면, "TranslatePress encountered SQL errors" 오류가 발생할 경우
- 설정 » TranslatePress » General 탭에서 저장 버튼을 눌러 테이블을 재생성하거나
- TranslatePress 플러그인을 최신 버전으로 업데이트하면 문제가 해결될 수 있습니다.
마치며
이상으로 TranslatePress 플러그인에서 SQL 에러가 발생하는 경우 대처 방법에 대하여 살펴보았습니다.
클라이언트 사이트의 경우 해외에서 개발하여 카페24로 마이그레이션한 한 케이스였는데, 페이지 로딩하는 데 20~30초가 걸릴 정도로 너무 오래 걸렸습니다. 조금 이해할 수 없는 것이 엘리멘터, TranslatePress, 우커머스 등 대부분의 플러그인 버전이 최신 버전이 아니었습니다. 사이트 개발을 시작할 때 설치한 플러그인들을 그대로 유지해서 그럴 수도 있을 것 같다는 생각이 드네요.
최신 워드프레스 버전이 설치된 경우 호환성을 위해 테마와 플러그인도 최신 버전으로 유지하는 것이 바람직합니다.
댓글 남기기