Fehler 153 bei eingebetteten YouTube-Videos: warum er auftritt und wie du ihn behebst

Fehler 153 heißt: Der YouTube-Player weiß nicht, welche Website ihn eingebettet hat, weil der Referer-Header fehlt. Die Lösung für Websites, WebViews und Apps.

Du bettest ein YouTube-Video ein, der Player lädt, und statt des Videos siehst du einen schwarzen Kasten mit „Error 153. Video player configuration error“ (Fehler 153, Konfigurationsfehler des Videoplayers), oft mit einem Link „Auf YouTube ansehen“. Das Video ist in Ordnung, der Einbettungscode auch. Was fehlt, ist die Information, wer es einbettet.

Die Ursache: Der Player weiß nicht, welche Website ihn eingebettet hat

Die Entwicklerbedingungen von YouTube sind eindeutig. Auf der Seite Required Minimum Functionality steht, dass alles, was den eingebetteten Player nutzt, einschließlich der IFrame Player API, sich über den HTTP-Header Referer ausweisen muss. Browser senden ihn normalerweise von selbst; die Seite bittet darum, keine Einstellungen zu verwenden, die ihn unterdrücken, und empfiehlt die Referrer-Policy strict-origin-when-cross-origin.

Lädt der Player ohne Referer, oder mit einem, der keine Website erkennen lässt, verweigert er die Wiedergabe und zeigt Fehler 153. Entwickler, die das debuggt haben, etwa Simon Willison, sind genau dort gelandet. Die Seite von Google nennt die Nummer 153 nicht, aber die beschriebene Lösung ist die, mit der der Fehler verschwindet.

Was den Referer auf einer Website entfernt

  • Ein Referrer-Policy-Header mit no-referrer oder same-origin. Manche Frameworks und Sicherheits-Setups setzen ihn standardmäßig; bei Willison war es Djangos SecurityMiddleware, die same-origin sendet.
  • Ein Meta-Tag im Head der Seite: <meta name="referrer" content="no-referrer">.
  • Ein referrerpolicy-Attribut direkt am iframe, manchmal von einem Einbettungs-Plugin gesetzt.
  • noreferrer an einem Fenster, das du für den Player öffnest, wovon die YouTube-Seite abrät.

Die Lösung auf einer Website

Sende die Policy, die YouTube empfiehlt, als Header:

Referrer-Policy: strict-origin-when-cross-origin

oder als Meta-Tag, wenn du die Header nicht ändern kannst:

<meta name="referrer" content="strict-origin-when-cross-origin">

Prüf danach, dass nichts Spezifischeres sie überschreibt: Entferne ein referrerpolicy-Attribut am iframe oder setz es auf denselben Wert. Diese Policy sendet anderen Websites nur deinen Origin (zum Beispiel https://beispiel.de), nie den vollständigen Pfad, du gibst also keine nennenswerte Privatsphäre auf. Willison stellte außerdem fest, dass der Wechsel auf youtube-nocookie.com nur manchmal half; gelöst hat es die korrigierte Policy.

Die Lösung in einer App (WebView, Electron, Tauri)

Apps trifft es häufiger, weil ihre Seiten nicht von einer Website kommen. Eine Seite, die aus einer lokalen Datei oder über ein eigenes Schema geladen wird (file://, app://, tauri://localhost), hat keinen Web-Origin, den sie senden könnte, also bekommt der Player keinen brauchbaren Referer. Die YouTube-Seite nennt, was je Plattform zu tun ist:

  • Mobile WebView mit lokalem HTML: Setz den Parameter baseUrl, der den Referer bestimmt.
  • SFSafariViewController unter iOS: Er kann keinen Referer setzen, nutz stattdessen den Player-Parameter origin.
  • Desktop-Apps: Füge den Referer als HTTP-Header zur Anfrage hinzu, oder konfiguriere die WebView so, dass sie einen sendet.

Eine letzte Option, wenn du die Header der WebView nicht steuern kannst: Leg auf einer echten https-Domain, die dir gehört, eine kleine Seite ab, die den Player einbettet, und zeig diese Seite in deiner App. Der Player sieht dann deine Domain als Einbettende.

Wie wir darauf gestoßen sind

Wir entwickeln Webstarted Toolbox, eine Menüleisten-App auf Basis von Tauri, und ihr Widget Media spielt YouTube-Videos ab. Die Oberfläche läuft auf tauri://localhost, was kein gültiger Web-Origin ist, also scheiterte ein direkter youtube.com/embed-iframe jedes Mal mit Fehler 153. Gelöst haben wir es mit der letzten Option: Das Widget zeigt eine kleine Seite auf unserer eigenen https-Domain, die einen korrekten Referer sendet und den Player einbettet. Das Video selbst kommt weiterhin direkt von Google zu den Zuschauenden; nur diese kleine Seite läuft über unseren Server.

Wenn du das Video nur ansehen willst

Der Fehler liegt bei der Website oder App, die das Video eingebettet hat, nicht bei dir. Der Link „Auf YouTube ansehen“ spielt es auf youtube.com ab. Eine Ausnahme lohnt den Blick: Eine Browser-Erweiterung oder Datenschutzeinstellung, die den Referer aus allen Anfragen entfernt, entfernt denselben Header und kann Fehler 153 auch auf korrekt konfigurierten Websites auslösen.

Quellen