缓存下载失败——卡住 0%、下载中断、缓存好放不出来

三种表现

表现一：下载一直卡在 0%

点了缓存按钮，加入队列后一直显示"0% 已下载"，过了几十秒也不开始。

表现二：下载到一半停住

比如一部 200 话的漫画下载到 120 话时停了，或一部 150MB 的动漫下载到 80MB 时卡住不动。

表现三：缓存完成但放不出来

显示"✅ 已缓存"，离线状态下点开却加载不出来或黑屏。

表现一：卡在 0%

最常见原因

• 网络差：连不上缓存服务器
• 并行下载数过多：同时下载任务太多排队，后面的一直等
• 存储权限被拒绝（缓存需要写入本地存储）
• 存储空间不足

处理

1. 切网络：先确认不是网络问题
2. 降低并行下载数：设置 → 离线缓存 → 并行下载数（从默认 10 降到 3-5）
3. 检查存储权限：设置 → 应用管理 → Palipali → 权限 → 存储 = 允许
4. 检查剩余空间：设置 → 存储，确保剩余 ≥ 1GB
5. 暂停其他下载任务，只留一个当前的试试
6. 清临时文件后重新开始

表现二：下载到一半停住

最常见原因

• 网络信号中断后没自动恢复：虽然 Palipali 支持断点续传，但某些版本在弱网下恢复得慢
• 图源服务器临时抖动（漫画缓存）
• 视频源线路卡了（动漫缓存）
• 存储空间在下载中途满了

处理

1. 手动暂停再恢复：缓存管理里找到这个任务 → 暂停 → 等 5 秒 → 恢复
2. 取消后重新下：如果暂停恢复也没用，取消后从头开始下（之前下的部分会被清理）
3. 切网络：WiFi 切数据或反之
4. 检查剩余空间：下载中途空间满是常见原因
5. 换个时间再试：如果是服务器抖动，等半小时一小时再试通常就好了

断点续传

Palipali 理论上支持断点续传——下载中断后恢复网络，应该继续剩下的部分。但实际体验上：

• 动漫缓存的断点续传相对稳定
• 漫画缓存（图片）的断点续传取决于图源服务器支持度，有些图源不支持续传，断了只能重来

表现三：缓存完成但放不出来

最常见原因

• 缓存文件损坏（下载中断没正确恢复，或手机在下载过程中突然断电/重启）
• 版本升级后缓存索引不匹配（老版本下载的缓存在新版本里可能识别不了）
• 手动删除了缓存目录里的部分文件（不要手动删目录！）
• 存储挂载异常（部分机型在 USB 存储模式或 SIM 卡挂载状态下缓存目录暂时不可访问）

处理

1. 删除这部的缓存 → 重新下载（最常用也最有效的方法）
2. 清应用数据（⚠️ 清掉所有本地收藏/记录/缓存）
3. 重启手机
4. 检查设置里的缓存目录路径：如果 Palipali 支持自定义缓存目录，确认路径有效（比如指定到一个不存在的目录会导致缓存好但读不出来）

防止下次再出现

• 下载时别强杀应用：让 Palipali 在后台自由下载
• 下载过程中别重启手机：虽然有断点续传，但不是所有情况都能恢复
• 别手动删缓存目录：只用 Palipali 内部的缓存管理界面清理
• 定期清理：缓存满了及时清，避免存储空间不足

WiFi 自动下载失败

如果是自动下载（订阅更新后 WiFi 自动缓存）失败：

1. 检查自动下载总开关有没有开
2. 检查是不是 WiFi 环境（自动下载只在 WiFi 下触发）
3. 手动去收藏 tab 点这部作品手动触发下载（相当于绕过自动逻辑测试）
4. 手动能下载 → 自动逻辑可能有 bug，可以关掉自动下载改用手动

缓存和网络的关系

• 缓存需要网络才能下（不管 WiFi 还是数据）
• 缓存完成后离线可以看（不依赖网络）
• 自动下载需要网络 + WiFi 环境 + 自动下载开关，三者缺一不可
• 断网不会触发自动下载——恢复网络时会检查有没有待下载的更新