"Watch Video on YouTube" 메시지와 함께 오류 코드 153(Video Player Configuration Error, 비디오 플레이어 구성 오류)가 나타나면, 임베드된 YouTube 플레이어 또는 앱 내 플레이어에서 영상이 정상적으로 로드되지 않고 재생 대신 빈 화면이나 멈춘 화면만 표시됩니다.
이 오류는 임베드 플레이어가 재생을 시작하는 데 필요한 구성(configuration)을 생성하지 못할 때 발생합니다. 주된 원인은 리퍼러(referrer) 또는 오리진(origin) 정보가 누락되거나 차단되었기 때문입니다. 이 정보가 없으면 플레이어는 정상적으로 초기화되지 않습니다.
핵심 원인: 웹페이지나 앱이 YouTube에 유효한 referrer 및 origin 헤더를 전송하지 않는 경우입니다. 이 헤더들은 요청이 어디서 왔는지를 YouTube에 알려주는 역할을 하며, 차단·제거·비어 있는 상태라면 플레이어가 요청을 검증할 수 없습니다.
그 외 흔한 원인
- 유효한 리퍼러 정보 없이
youtube.com/embed/URL을 부적절하게 사용하는 경우 - 브라우저 확장 프로그램이나 개인정보 보호 도구가 referrer 헤더를 차단하는 경우
- 임베드 코드에
origin또는referrerpolicy속성이 잘못되었거나 누락된 경우
참고: 아래 해결 방법 중 일부는 영상을 시청하려는 사용자를 위한 것이고, 일부는 임베드 코드를 관리하는 웹사이트·앱 운영자를 위한 것입니다. 각 방법마다 해당 대상을 명시해 두었으니 자신에게 맞는 방법을 적용하세요.
1. YouTube 쿠키 삭제하기 (시청자용)
오래되었거나 손상된 YouTube 쿠키는 플레이어가 구성 정보를 불러오는 과정을 방해할 수 있습니다. 쿠키를 삭제하면 YouTube가 새로운 재생 세션을 다시 생성합니다.
- 브라우저에서 YouTube를 엽니다.
- F12 키를 눌러 개발자 도구(DevTools)를 실행합니다.
- Application(애플리케이션) 탭으로 이동합니다. 탭이 숨겨져 있다면 » 아이콘을 클릭하세요.
- Storage 항목에서 Cookies를 확장한 뒤 https://www.youtube.com을 선택합니다.
- 마우스 오른쪽 버튼을 클릭하고 Clear(삭제)를 선택합니다.
- 페이지를 새로고침한 후 영상을 다시 재생해 봅니다.
2. 다른 브라우저로 시도하기 (시청자용)
다른 브라우저에서 영상이 정상적으로 재생된다면, 기존 브라우저가 중요한 헤더를 차단하거나 손상된 캐시를 사용하고 있을 가능성이 높습니다.
- Chrome, Edge, Firefox 등 다른 브라우저를 엽니다.
- 오류가 발생한 동일한 페이지에 접속합니다.
- 임베드된 영상을 재생해 봅니다.
- 정상 작동한다면 기존 브라우저로 돌아가 캐시를 삭제하거나 브라우저를 초기화합니다.
3. 충돌하는 확장 프로그램 비활성화하기 (시청자용)
광고 차단기, 개인정보 필터, 스크립트 차단기 같은 확장 프로그램은 YouTube가 요구하는 referrer 헤더의 전송을 막는 경우가 많습니다. 이를 비활성화하면 정상적인 통신이 복원됩니다.
- 브라우저의 확장 프로그램(Extensions) 또는 애드온(Add-ons) 페이지를 엽니다.
- 광고 차단, 개인정보 보호, 추적 방지, JavaScript 제어와 관련된 확장 프로그램을 모두 비활성화합니다.
- 영상 페이지를 새로고침합니다.
- 영상이 재생되면 확장 프로그램을 하나씩 다시 켜면서 원인이 되는 항목을 찾습니다.
4. 앱 업데이트하기 (모바일 시청자용)
뉴스 앱, 학습 앱처럼 YouTube 영상을 임베드하는 모바일 앱에서 오류가 발생한다면, 오래된 컴포넌트가 YouTube의 최신 재생 규격을 충족하지 못했을 수 있습니다. 아래 두 가지를 모두 업데이트하세요.
- YouTube 공식 앱
- 임베드 영상을 표시하는 앱
- Play 스토어(또는 App Store)를 엽니다.
- YouTube를 검색하고 업데이트가 있다면 업데이트를 탭합니다.
- 오류가 발생한 앱도 함께 최신 버전으로 업데이트합니다.
5. 임베드 URL 변경하기 (웹사이트·앱 운영자용)
웹사이트나 앱을 직접 관리하는 경우, 도메인을 youtube-nocookie.com으로 변경하면 특정 개인정보 관련 제약을 피할 수 있고 더 깔끔한 referrer 데이터가 전송되어 요청 차단을 예방할 수 있습니다.
- 임베드 코드가 저장된 HTML 편집기 또는 CMS를 엽니다.
- 다음과 같은 iframe 코드를 찾습니다.
https://www.youtube.com/embed/VIDEO_ID- 아래와 같이 변경합니다.
https://www.youtube-nocookie.com/embed/VIDEO_ID- 저장 후 페이지를 새로고침합니다.
6. YouTube iframe에 Referrer Policy 추가하기 (웹사이트·앱 운영자용)
YouTube는 임베드 요청을 검증하기 위해 유효한 referrer/origin 데이터가 필요합니다. 브라우저가 이 헤더를 차단하거나 제거하면 플레이어가 오류 코드 153으로 실패합니다. referrer policy를 지정하면 브라우저가 필요한 정보를 전송하도록 강제할 수 있습니다.
- HTML 편집기를 엽니다.
- YouTube iframe 태그를 찾습니다.
- iframe 태그 안에 아래 속성을 추가합니다.
referrerpolicy="strict-origin-when-cross-origin"적용 예시:
<iframe src="https://www.youtube.com/embed/VIDEO_ID" referrerpolicy="strict-origin-when-cross-origin"></iframe>변경 사항을 저장하고 페이지를 새로고침하여 문제가 해결되었는지 확인하세요.
작성자 소개
Muhammad Usman Ashraf — WordPress 개발, SEO, 문제 해결 가이드 분야에서 폭넓은 경험을 갖춘 콘텐츠 작가이자 웹사이트 전문가입니다. Appuals에서 사용자들이 기술적인 문제를 간단명료한 단계로 해결할 수 있도록 심층 가이드를 집필하고 관리하고 있습니다. 창의성과 기술 역량을 결합하여 누구나 쉽게 접근할 수 있고 검색엔진에 최적화된 유용한 콘텐츠를 만드는 데 열정을 가지고 있습니다.