首页 / 知识库 / 播放

M3U8 播放失败排查清单

遇到 M3U8 播不了,不要盲目重试。按下面的顺序逐项排查,效率最高。

1. 链接是否有效

把地址直接用浏览器打开,看是否能下载到以 #EXTM3U 开头的文本。若 404 或返回错误页面,说明链接失效。

2. 用桌面播放器交叉验证

在 VLC 中打开同一地址。VLC 能播而网页不能,几乎可以断定是 CORS 问题;两者都不能,则多半是源本身的问题。

3. 检查跨域(CORS)

在浏览器控制台查看是否有 CORS 报错。若有,说明源站未允许你的域名访问,需要换源、配置代理或用桌面播放器。

4. 检查编码兼容性

部分浏览器不支持某些编码(如 HEVC、AV1 在特定平台)。确认视频编码为 H.264、音频为 AAC 通常最稳妥。

5. 检查加密

清单含 #EXT-X-KEY 时,若密钥获取失败也会播不了。DRM 内容只能在支持的客户端观看。

排查时记录每一步的结果,往往能快速锁定问题环节。多数"诡异"问题,最后都是链接失效或跨域这两类原因。
← 录制 HLS 直播流:把实时变成可回放从制作端提升 HLS 播放体验 →