Checklist CORS (m3u8 / ts / key)
Publié:2026-02-04 · Lecture 12 min
Contrôles CORS actionnables pour playlist, segments et clés.
Check every request type, not only the playlist
Many M3U8 CORS issues happen because the playlist responds correctly, but TS segments, CMAF chunks, or key endpoints still block cross-origin requests.
Verify the response headers on the playlist, every media segment type, subtitle files, and encryption keys before declaring CORS fixed.
Verify headers after CDN, cache, and origin rewrites
It is common for the origin to send the right header while the CDN edge strips, caches, or rewrites it incorrectly.
Compare headers from browser devtools, curl, and multiple regions so you can tell whether the issue is global or edge-specific.
Validate preflight and credential behavior
If your playback requests include custom headers, cookies, or signed fetch logic, preflight rules can break even when simple GET requests look fine.
Check allowed methods, allowed headers, credential settings, and whether wildcard origins are conflicting with authenticated requests.
Checklist opérationnelle
Vérifiez l’URL, les en-têtes de réponse et la continuité des segments sur la même période avant de modifier le player.
Conseil de collaboration
Exportez le snapshot de debug avec navigateur/appareil/heure/région pour accélérer l’analyse de cause racine.
Approche de diagnostic
Ne vous fiez pas à un seul message d’erreur. Corrélez logs, statuts HTTP et chronologie avant de conclure.
Séquence recommandée
- Vérifier l’URL et le format de playlist
- Contrôler CORS/auth sur playlist, segments et clés
- Comparer les échecs par niveau de qualité et région
- Utiliser les tendances pour distinguer jitter et panne continue
- Partager un snapshot de debug pour l’investigation
Stratégie de diagnostic approfondie
En production, évitez de modifier plusieurs variables en même temps. Isolez une variable par itération (réseau, token URL, niveau qualité ou région CDN) pour comparer les preuves proprement.
Tenez une chronologie courte avec heure précise et symptômes observés. Elle permet de corréler les événements du player avec les logs CDN/origine et d'accélérer l'analyse de cause racine.
À collecter avant escalade
- URL de lecture d'origine et présence d'une signature
- Fuseau horaire + heure exacte de l'échec
- Navigateur/appareil/OS et type de réseau
- Extrait des logs d'événements autour de l'incident
- Lignes de segments avec code HTTP et temps de chargement
- Reproductibilité selon région ou opérateur