Yoast SEO 플러그인은 워드프레스 사용자들에게 필수적인 도구 중 하나입니다. 그러나 때때로 예기치 않은 오류가 발생할 수 있습니다. 최근 많은 사용자들이 “Cannot read properties of undefined (reading ‘prevOffset’)” 오류를 경험하고 있으며, 이 문제의 주요 원인 중 하나로 번역 파일이 지목되고 있습니다.
오류 원인
이 오류는 일반적으로 Yoast SEO 플러그인의 번역 파일이 제대로 로드되지 않거나, 플러그인의 특정 버전과 번역 파일 간의 충돌이 발생할 때 나타납니다. 번역 파일이 잘못 적용되면 JavaScript 코드에서 필요한 변수를 찾을 수 없어 오류가 발생할 수 있습니다.
가장 쉬운 해결 방법: 영어 설정으로 변경
번역 파일이 문제를 일으키는 경우, 가장 간단한 해결 방법은 Yoast SEO 플러그인을 영어로 설정하는 것입니다. 이를 통해 플러그인이 기본 영어 UI로 작동하며, 번역 파일 로딩 문제를 회피할 수 있습니다.
영어로 설정하는 방법
- 워드프레스 관리자 페이지에서
설정(Settings)→일반(General)로 이동합니다. 사이트 언어(Site Language)옵션을English (United States)로 변경합니다.변경 사항 저장(Save Changes)버튼을 클릭합니다.- 워드프레스 관리자 페이지를 새로고침한 후, Yoast SEO를 다시 확인합니다.
이 방법으로 문제를 해결할 수 있다면, 번역 파일이 원인임이 확실하므로 이후 업데이트에서 수정되었는지 확인하는 것이 좋습니다.
다른 해결 방법
영어로 설정하는 것이 최선이 아니라면, 아래 방법을 시도해볼 수 있습니다.
1. Yoast SEO 플러그인 재설치
플러그인(Plugins)메뉴에서 Yoast SEO를 비활성화한 후 삭제합니다.새 플러그인 추가(Add New Plugin)에서 Yoast SEO를 다시 설치하고 활성화합니다.- 오류가 사라졌는지 확인합니다.
2. 캐시 및 브라우저 데이터 삭제
브라우저 캐시나 사이트 캐시가 오래된 번역 파일을 참조할 가능성이 있으므로, 아래 방법을 시도해 보세요.
WP Rocket,W3 Total Cache,LiteSpeed Cache같은 캐시 플러그인이 있다면 캐시를 모두 삭제합니다.- 브라우저의 캐시 및 쿠키를 삭제한 후 다시 확인합니다.
3. 번역 파일 강제 업데이트
워드프레스 관리자 페이지에서업데이트(Updates)로 이동합니다.번역 업데이트(Update Translations)버튼이 있다면 클릭하여 최신 번역 파일을 다운로드합니다.- 문제가 해결되었는지 확인합니다.
4. 플러그인 충돌 확인
다른 플러그인과 충돌할 가능성도 있습니다. 이를 확인하려면:
- 모든 플러그인을 비활성화한 후 Yoast SEO만 활성화합니다.
- 오류가 사라지면 하나씩 플러그인을 활성화하며 원인을 찾습니다.
결론
Yoast SEO의 ‘Cannot read properties of undefined (reading ‘prevOffset’)’ 오류는 번역 파일 문제로 인해 발생하는 경우가 많습니다. 따라서 가장 쉬운 해결책은 사이트 언어를 영어로 변경하는 것입니다.
만약 영어 설정이 불가능하다면, 플러그인 재설치, 캐시 삭제, 번역 파일 업데이트, 플러그인 충돌 점검 등의 방법을 시도해볼 수 있습니다. 앞으로 Yoast SEO 플러그인 업데이트를 통해 이 문제가 해결될 가능성이 높으므로, 최신 버전 유지도 중요한 해결책 중 하나입니다.