用户为什么会进入 Troubleshooting 这条线

这些是公开排障页最应该先承接的故障模式。

• M3U8 链接打不开，或者看起来像失效了。
  先检查可达性、响应状态和 token 是否过期，再决定要不要重试播放或下载。
• 流能打开，但变体、音轨、字幕或分片看起来不对。
  先做清单结构检查，再判断是不是源本身有问题。
• 已经开始播放，但音频、字幕或设备表现仍然异常。
  在确认访问和结构后，再进入对应症状页继续排查。

需要尽早分开的常见原因

不要把所有播放投诉都压成一句“播放器坏了”。

• 访问失败和播放器失败不是一回事。
  403、404、token 过期、CORS 拦截，和播放器渲染问题需要不同的第一步。
• 清单结构问题经常伪装成普通播放报错。
  变体、编码、音轨、字幕引用和分片引用异常，即使链接可达也会导致播放异常。
• 排障页应该负责判断下一步，而不是假装所有浏览器都能彻底修好流。
  公开层故障排查的价值在于先定层级、再导向正确工具和指南。

推荐顺序

先走诊断路径，再决定要不要升级到更重的执行。

1. 先查链接可达性。
   先用 M3U8 链接检查确认 URL、状态码和明显访问失败。
2. 再查清单结构。
   当变体、音轨、字幕或分片仍然可疑时，进入 M3U8 Inspector。
3. 最后才回播放器或症状页复测。
   只有在访问和结构已经分清后，才回 M3U8 Player 或对应症状页继续。

M3U8 链接检查

当用户的起点是“打不开”或“之前能用现在突然不行”，链接检查是最快的第一层真相验证。

M3U8 打不开

先打开对应问题页，再回到正确工具。

HLS 播放报错

先打开对应问题页，再回到正确工具。

M3U8 没有声音

先打开对应问题页，再回到正确工具。