播放出错先看这份按症状排查的路线图
排障最重要的不是会多少招，而是按症状分流：不同症状走完全不同的代码路径，混着试只会把简单问题搞复杂。这份路线图把社区文档的排查体系压成一张导览。
第一步永远是这两件
- 对照最新版本：很多「Bug」在新版里已经修了，先去发布页看版本（更新方法见 四个更新渠道哪个更适合日常追新）；
- 复现一次并记录：出错时间、受影响的地址或搜索词、当前选的 YouTube 提取端点——后面每个分支都要用。
按症状对号入座
| 症状 | 去哪 | 别做什么 |
|---|---|---|
| 所有 YouTube 视频几秒内全失败 | DNS 过滤导致所有视频失败 | 别先动端点、别重装、别升级 WebView |
| 提示 WebView 不可用 / 无可用提供者 | WebView 与受保护播放 | 别以为换端点能绕过 WebView 检查 |
| 提示「确认你不是机器人」 | 出现机器人验证提示怎么办 | 别当成缓存或 WebView 问题 |
| 超长视频报 SABR 分段数错误 | SABR 与超长视频 | 别以为是时长本身不支持 |
| 个别视频失败，其它都能放 | 只有个别视频放不出来怎么定位 | 别先重装 WebView 或改 DNS |
| 搜索结果空 / 错乱 | 搜索分支（见下） | 别指望修播放能修好搜索 |
| 下载失败或文件不完整 | 下载到一半失败或文件不完整怎么办 | 别先删掉唯一的部分文件 |
| 换机后本地数据丢失 | 换机前怎么备份订阅历史和播放列表 | 别假设导入是可逆合并 |
两条铁律
- 先分清服务：YouTube 的端点解释不了 B 站或 Niconico 的失败——报问题先说服务名；
- 一次只改一个变量：「同视频、单改动、再重试」才有诊断价值，五个开关一起拨等于白测。
按分支处理完还没解决的，把过程整理成报告反馈，模板在 上报问题前要准备哪些信息。