Kegagalan request key HLS (AES-128 / SAMPLE-AES)
Diterbitkan:2026-02-04 · Baca 12 menit
Troubleshooting akses URI key, auth, dan CORS untuk stream terenkripsi.
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.
Checklist operasional
Sebelum mengubah konfigurasi player, validasi URL, header respons, dan kontinuitas segmen pada rentang waktu yang sama.
Tips kolaborasi
Ekspor snapshot debug beserta browser/perangkat/waktu/wilayah agar analisis akar masalah lebih cepat.
Pendekatan diagnosis
Jangan hanya melihat satu pesan error. Korelasikan event log, kode HTTP, dan timeline sebelum menyimpulkan.
Urutan yang disarankan
- Validasi URL dan format playlist
- Cek CORS/auth pada playlist, segmen, dan key
- Bandingkan pola gagal per level kualitas dan wilayah
- Gunakan tren untuk pisahkan jitter vs gangguan berkelanjutan
- Bagikan snapshot debug untuk investigasi tim
Strategi diagnosis mendalam
Di produksi, jangan ubah banyak variabel sekaligus. Kunci satu variabel per iterasi (jaringan, token URL, level kualitas, atau region CDN) agar pembandingan data tetap valid.
Simpan timeline singkat dengan timestamp dan gejala yang terlihat. Ini memudahkan korelasi event player dengan log CDN/origin sehingga akar masalah lebih cepat ditemukan.
Data yang dikumpulkan sebelum eskalasi
- URL pemutaran asli dan status tanda tangan
- Zona waktu + waktu kejadian yang presisi
- Browser/perangkat/OS dan jenis jaringan
- Cuplikan event log di sekitar waktu gagal
- Baris segmen dengan kode HTTP dan waktu muat
- Apakah masalah muncul juga di region/ISP lain