CORS 점검 체크리스트 (m3u8 / ts / key)

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.

운영 체크리스트

플레이어 설정을 바꾸기 전에 같은 시간대의 URL 접근성, 응답 헤더, 세그먼트 연속성을 먼저 확인하세요.

협업 팁

브라우저/기기/시간/지역 정보를 포함한 디버그 스냅샷을 공유하면 원인 분석이 빨라집니다.

진단 접근법

하나의 오류 문구만 보지 말고 이벤트 로그, HTTP 코드, 타임라인을 함께 보며 판단하세요.

권장 점검 순서

• URL 유효성과 playlist 형식 확인
• playlist/segment/key의 CORS/auth 확인
• 화질 레벨·지역별 실패 패턴 비교
• 추세 지표로 일시적 흔들림과 지속 장애 구분
• 디버그 스냅샷 공유로 협업 가속

심화 진단 전략

운영 환경에서는 여러 변수를 동시에 바꾸지 마세요. 네트워크, URL 토큰, 화질 레벨, CDN 지역 중 한 가지만 고정해 비교하면 원인 추적이 훨씬 정확해집니다.

정확한 시간과 증상을 포함한 짧은 타임라인을 남기면 플레이어 이벤트와 CDN/origin 로그를 쉽게 대조할 수 있어 시행착오를 줄일 수 있습니다.

에스컬레이션 전 수집 항목

• 원본 재생 URL 및 서명 여부
• 타임존 + 정확한 장애 시각
• 브라우저/기기/OS 및 네트워크 유형
• 장애 전후 이벤트 로그 구간
• HTTP 상태와 로드 시간이 포함된 세그먼트 행
• 다른 지역/ISP 재현 여부