HLS-Key-Fehler (AES-128 / SAMPLE-AES)

Typical symptom

Video appears to load but fails to render because decryption key requests fail.

Checklist

Validate key URI reachability, auth token validity, and CORS headers on key endpoints.

Betriebliche Checkliste

Prüfen Sie URL-Erreichbarkeit, Response-Header und Segment-Kontinuität im selben Zeitraum, bevor Sie Player-Parameter ändern.

Team-Hinweis

Exportieren Sie den Debug-Snapshot mit Browser/Gerät/Zeit/Region für schnellere Ursachenanalyse.

Diagnoseansatz

Nicht nur auf eine Fehlermeldung verlassen. Logs, HTTP-Codes und Zeitverlauf gemeinsam auswerten.

Empfohlene Reihenfolge

• URL und Playlist-Format prüfen
• CORS/Auth für Playlist, Segmente und Keys prüfen
• Fehlermuster nach Qualitätsstufe und Region vergleichen
• Trends nutzen, um Jitter vs. Dauerproblem zu trennen
• Debug-Snapshot für Teamanalyse teilen

Vertiefte Diagnose-Strategie

In Produktion sollten Sie nicht mehrere Variablen gleichzeitig ändern. Isolieren Sie pro Runde genau eine Variable (Netz, URL-Token, Qualitätsstufe oder CDN-Region), damit Ergebnisse vergleichbar bleiben.

Führen Sie eine kurze Timeline mit exakten Zeitstempeln und Symptomen. So lassen sich Player-Events mit CDN/Origin-Logs korrelieren und die Ursache schneller eingrenzen.

Vor Eskalation erfassen

• Original-Playback-URL und Signaturstatus
• Zeitzone + exakter Fehlerzeitpunkt
• Browser/Gerät/OS und Netztyp
• Event-Log-Ausschnitt rund um den Fehler
• Segmentzeilen mit HTTP-Status und Ladezeit
• Reproduzierbarkeit in anderen Regionen/ISPs