下载失败排查：重定向、假下载与 HLS 任务处理
聚合类播放器的下载链路天生比普通播放器复杂：来源多、协议杂、线路质量参差。好在开发者在 1.5.25 的更新日志里一口气修了三个下载侧 bug，把最常见的坑填了大半。
1.5.25 修复的三类下载问题
| 问题 | 表现 | 成因 |
|---|---|---|
| 重定向下载失败 | 任务刚开始就报错 | 视频链接存在重定向，旧版没处理好跳转 |
| HLS 假下载 | 进度跑了但文件不能用 | 部分 HLS 格式视频的分片校验不完整 |
| 错误状态码 | 资源明明可访问却报错 | 状态码判断逻辑过于严格 |
第一动作永远是升级到最新版——你遇到的下载问题很可能已经被修掉了。
升级后仍失败的排查清单
- 换线路再下：同一集往往有多条线路，当前线路的源不稳定是最大变量（线路概念见选集与线路）。
- 看资源角标：没带「有资源」角标的集数，下载成功率本来就低。
- 检查存储空间：空间不足时任务会莫名失败，先按大小预估估算所需空间。
- 重试与清队列：删除失败任务重新添加；队列堆积过多时先清空再下。
- 网络环境：切换 Wi-Fi/移动数据对比测试，部分源对特定网络出口敏感。
- 确认格式支持：个别特殊编码或协议的源可能只是「能播不能下」，属正常现象。
磁力链接的特殊情况
1.5.11 起支持磁力链接在线播放，1.5.22 加入磁力链接手动资源选择。磁力任务的下载速度取决于做种数量：
- 资源冷门（做种少）→ 速度慢或卡在元数据获取，换热门资源或放弃。
- 手动资源选择可以只挑需要的文件，避开整包里的无效内容。
还是不行
- 到应用商店评论区或项目仓库反馈，附上番剧名、集数与报错提示，开发者修复下载问题的响应速度在更新日志里是有记录的。
- 急着离线看的话，临时用投屏或在线播放顶一顶。