下载失败与路径无效：换路径、查权限与重新下载的处理

离线下载链条上最常见的故障是「下载路径无效」，其次是普通的任务失败。前者几乎总是一个原因：所选路径不可写。

「下载路径无效」的处理

官方 FAQ 的归因很直接：设置下载路径后下载失败，通常是所选路径有问题。按此处理：

1. 更换下载路径——在下载设置里把路径改回内部存储的默认目录，这是兼容性最好的选择
2. 检查写权限——自定义路径必须落在应用有写权限的目录内；指向存储卡根目录、其他应用私有目录等位置都会失败
3. 确认存储可用——目标分区剩余空间不足同样表现为失败，清理出双倍于任务体积的空间（清理方法见存储清理）
4. 重新发起任务——改完路径后，删除失败任务重新下载

更改路径只对新任务生效，已成功的缓存不会迁移。

普通下载失败的处理

不属于路径问题的失败，按通用套路排查：

1. 网络因素

• 切换 WiFi / 流量对比
• 弱网下大体积任务容易中途断，改在稳定网络重试

2. 任务因素

• 队列拥堵时个别任务长期排队，不是失败是没轮到——检查队列状态（见下载队列）
• 调整任务优先级，把急用的提到前排

3. 资源因素

• 个别剧集的下载源异常，表现为只有这一集下不动——换一条线路的下载源，或跳过该集
• 与播放侧同理，资源可能临时不可用，稍后再试

速查表

下载链路讲完，下一页是大屏链路：投屏断连。