NekoAnime 离线缓存偶尔失效是什么原因：缓存番剧放不出来的排查
「明明缓存好了，断网一看却放不出来」——离线缓存的这个毛病在用户反馈里出现过，v0.5.1 的更新日志里也白纸黑字写着修复项：「离线缓存偶尔失效」。这一页把缓存失效的几种原因和对应排查讲清楚。
先升级，再排查
v0.5.1 之前的版本存在缓存失效的已知缺陷，这是官方日志确认过的问题。还在用 v0.5.0 或更早版本的用户，第一优先级是升级到新版——多数「偶尔失效」的体验问题在 v0.5.1 就终结了。
升级注意保留数据：普通小版本走覆盖安装，缓存和追番数据都在；只有日志明确要求先卸载时才走卸载路径（判断方法见怎么升级）。
排查清单
升级后仍有缓存问题，按下面的顺序走：
- 确认「失效」的具体形态：是完全放不出来，还是部分集数放不出来、部分正常？个别集数失效多是下载时就没完成（进度没走满就断网了），删掉重缓该集即可；
- 在线状态验证：连上网后同一集能正常播 → 缓存文件本身的问题，重缓解决；在线也播不了 → 那是数据源/线路问题，转播放失败的排查顺序；
- 清理数据缓存后再试：应用的数据缓存偶尔会干扰缓存文件的索引，清一次（方法见清除数据缓存）再打开缓存列表看是否恢复；
- 检查系统清理工具：第三方清理 App 可能扫掉了应用数据目录里的视频文件（背景见缓存管理的「系统清理工具」一节）——表现为缓存列表条目还在、点开却放不出，重缓即可；
- 重启应用再试：缓存索引的偶发加载失败，重启即愈。
缓存与数据源的关系
一个原理性提醒：缓存失效 ≠ 数据源失效，但两者会被混在一起感知。
- 缓存失效：文件在你手机里，问题出在本地——重缓或升级解决；
- 数据源失效：源站或线路出问题（比如 v0.5.2 修复的「视频源地址被加密」），此时在线离线都不正常，只能等开发者适配——v0.5.2 就是一次典型的源侧变化引发的紧急修复。
区分方法就是上面第 2 条的「在线状态验证」。
都试过了还不行
带着具体信息去 GitHub Issues 反馈：应用版本、机型系统、失效的具体表现（哪部番哪一集、离线还是在线也失效）、复现步骤。反馈渠道与发帖礼仪见问题反馈的正确用法。