Troubleshooting HLS: checklist lengkap dari CORS ke 403

Check whether the M3U8 URL returns a real playlist

Open the URL directly in the browser and confirm it returns a playlist that starts with #EXTM3U.

If the response redirects to a login page, returns JSON, or serves HTML instead of a playlist, the video will never begin loading correctly.

Tell CORS errors apart from 401/403 auth failures

A CORS problem means the browser blocked access to the response, while 401 or 403 means the origin or CDN rejected the request.

Fix CORS with response headers on playlists, segments, and keys. Fix 401/403 by reviewing token expiry, signatures, referer rules, and origin authorization logic.

Inspect playlist, segment, key, and quality-level failures separately

Do not treat every playback failure as the same incident. Some streams fail only on one bitrate level, only on key requests, or only after a few segments have loaded.

Use the player event log and segment table to identify whether the failure is immediate, mid-playback, regional, or tied to a single variant stream.

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