这些症状通常属于下载链路，而不是盲目回到播放重试。

它们往往说明入口链接部分可用，但导出链路在后面才断掉。

manifest 看起来可用后，下载仍失败的常见原因。

很多下载失败本质上仍是访问或结构问题，只是出现得更晚。

按固定顺序排查 M3U8 下载失败。

先查访问，再查结构，最后才查导出假设。这样公开层能教会用户，而不是把工作台变成盲重试界面。

1. 先确认链接不只是首个请求有效

   快速链接检查可以先排掉令牌/鉴权过期。

2. 在怪罪导出器前先检查 manifest 树

   确认变体、加密和子分片结构足够稳定，再谈导出。

3. 只有在失败类型清楚后才回到 Downloader 工作台

   知道是访问、结构还是浏览器导出限制后，执行层才有意义。

导出失败时先用 Link Checker。

先跑一次轻量访问/manifest 可达性预检，再决定是否继续重试下载。

让下载失败按访问、结构、执行三条线依次排查。

别把所有失败导出都当成一件事。

相关入口

• M3U8 Link Checker
  先看令牌和 manifest 可达性。
• M3U8 Inspector
  查看变体、加密和子清单健康度。
• M3U8 Downloader
  只有在失败桶更清楚后才回到下载工具。

先命名失败桶，再决定是否继续导出。

• 为什么能播放却仍然导出失败？
  因为播放和导出压到的链路不同。后续分片请求、打包和浏览器限制都可能在导出时才失败。
• 要不要一开始就进 Downloader 工作台？
  只有在你已经知道是令牌、分片，还是浏览器导出限制后，工作台才值得进。
• 导出前最快的公开层预检是什么？
  先跑 Link Checker 或 manifest 检查，看源是否仍然足够稳定，值得继续导出。