TVBox怎么清理缓存？「从缓存加载jar失败」原因与解决方法（FongMi影视 / takagen99版通用，2026）

redpear

简介

今天必应搜索联想里，"tvbox 缓存"一词下面排着 "tvbox怎么清理缓存""tvbox盒子怎么清理缓存""tvbox电视盒子怎么清理缓存""tvbox从缓存加载jar失败"；B站联想有 "tvbox怎么清理接口缓存"；百度和 Google 联想也都出现了 "Tvbox从缓存加载jar失败"。

清缓存能解决很多"接口突然不更新""首页加载失败""播放卡顿""存储空间不足"的问题，但不同 TVBox 版本清缓存的入口和效果不一样：有的在设置页，有的藏在首页左上角，有的系统"清除缓存"还清不掉接口文件。本文对照 FongMi 影视 和 takagen99 版 TVBox 两个开源项目的源码，讲清楚怎么清、清掉了什么、"从缓存加载jar失败"到底是怎么回事。

一、TVBox 的"缓存"都有哪些

TVBox 系应用运行时会在本地保存几类文件：
· 接口爬虫文件（jar / js / py）：配置里 spider 字段指向的 jar 包，下载一次后缓存在本地，下次启动直接用，所以叫"接口缓存"；
· 播放缓存：边播边存的视频数据，用于拖动进度、减少重复下载；
· 节目单（EPG）缓存：直播的节目表；
· 图片缓存：海报、壁纸等。

接口更新了但 App 还在用旧 jar、jar 文件下载不完整、缓存占满存储空间——这些都是清缓存要解决的问题。

二、FongMi 影视怎么清理缓存

方法：设置 → 缓存
· 首页进入 设置；
· 找到 "缓存" 一行，右侧显示当前缓存大小（例如 236 MB）；
· 点一下即开始清理，数字变小即完成。

根据源码，这个按钮清除的是应用的 cache 目录，其中包括 jar / js / py 爬虫缓存、EXO 和 MPV 播放缓存、EPG 节目单缓存。也就是说，FongMi 的"缓存"按钮本身就会清掉接口缓存，清完下次进入点播会重新下载 jar。


▲ FongMi 影视"设置 → 缓存"清除的目录与 jar 缓存校验逻辑（依据 FongMi/TV 开源代码本地渲染）

补充：jar 的 md5 校验
如果配置里 spider 写成"jar地址;md5;校验值"的格式，FongMi 会先比对本地缓存的 md5，一致才复用缓存，不一致就重新下载。所以配置作者更新 jar 时同步更新 md5，用户端就能自动拿到新版。

三、takagen99 版 TVBox 怎么清理缓存

takagen99 版（以及很多基于它的改版）把清缓存放在了一个很隐蔽的地方：

· 首页单击左上角的应用名称：清空应用 cache 目录和外部 cache 目录，同时 删除当前首页源所用的 jar 缓存，然后自动重载首页，屏幕提示"已删除缓存"；
· 长按左上角的应用名称：不清缓存，只重新加载首页源。

这个设计很多人不知道，所以会去系统设置里清缓存——但是要注意下一节的坑。

四、「从缓存加载jar失败」是什么原因

这句提示出自 takagen99/Box 的源码。它的 jar 缓存放在应用 files/csp/ 目录下（文件名是 jar 地址的 md5）。加载逻辑是：

· 配置里给了 md5、或者本次启动要求"使用缓存"（例如切换首页源后重载）时，如果本地缓存存在，就直接加载这个缓存文件；
· 缓存文件存在但加载失败——提示 "从缓存加载jar失败"；
· 没有 md5 时，若缓存不足 15 天也会优先用缓存，过期才从网络重新下载。


▲ "从缓存加载jar失败"的出处：takagen99/Box 的 loadJar 逻辑与首页左上角清缓存按钮（依据 takagen99/Box 开源代码本地渲染）

因此，出现这个提示通常是：
· jar 缓存文件损坏或不完整：上次下载时网络中断、存储空间不足；
· jar 与当前 App 版本不兼容：接口作者更新了 jar，但你的 App 太旧（或反过来）；
· 配置里 md5 与实际 jar 不符：作者更新了 jar 没改 md5，导致 App 一直认缓存。

解决步骤（由易到难）
· 单击首页左上角应用名称，删除 jar 缓存后自动重载；
· 仍然失败：到系统 设置 → 应用 → TVBox → 存储 → 清除数据。注意 jar 在 files 目录，系统里的"清除缓存"清不掉它，必须"清除数据"；清除数据会清空配置地址、收藏和历史，先记下配置地址；
· 重新填写配置地址，确保网络能访问配置里的 jar 地址（可在电脑浏览器里试着打开）；
· 换一个配置或更新 App 到最新版，排除 jar 与 App 不兼容；
· 检查存储空间，剩余太少时 jar 写入会失败。

五、tvbox盒子怎么清理缓存（系统层面）

除了 App 内的按钮，电视盒子还可以在系统里清理：
· 系统设置 → 应用管理 → 找到 TVBox / 影视 → 清除缓存：清 cache 目录，安全，不影响配置；
· 清除数据：彻底重置，相当于重装，慎用；
· 部分盒子自带"清理加速"工具，同样只清 cache。

建议顺序：先用 App 内按钮 → 不行再系统"清除缓存" → 最后才"清除数据"。

常见问题

Q1：清了缓存，收藏和历史会丢吗？
App 内"缓存"按钮和系统"清除缓存"都 不会 删除收藏、历史和配置地址；只有系统里的"清除数据"会。想保险，FongMi 用户可以先在设置里点"备份"。

Q2：多久清一次比较好？
没有固定周期。出现接口不更新、加载失败、存储告急时再清即可；频繁清理会让每次启动都重新下载 jar，反而更慢。

Q3：清缓存后首页一直转圈？
说明 jar 重新下载失败，检查网络和配置地址，或换 DNS（FongMi 设置里可选 DoH）。

Q4：清完缓存播放更卡了？
播放缓存被清空后需要重新缓冲，属于正常现象，播放一会儿就恢复。

FongMi 影视 5.6.9 下载（双盘）

本站网盘提供 电视版 32 位安装包 leanback-armeabi_v7a.apk（5.6.9），与 FongMi 官方 GitHub 发布页同名文件一致，绝大多数电视、盒子、投影仪都能安装：

· 包名：com.fongmi.android.tv，versionCode 569
· 文件大小：134,157,000 字节（约 128MB）
· MD5：969F782A1F70AD2900C8E94846D0555E
· SHA-256：b52c0b84dcae01c3481919740eacb83f210c296e0d457d4d96f3f61f689b73e4

夸克网盘（免提取码）
https://pan.quark.cn/s/ba325a93ea40

百度网盘
https://pan.baidu.com/s/1I1jb5no7Lbt3wY88QUxTWQ
提取码：f474

手机版和 64 位电视版请到项目主页获取：FongMi/Release 5.6.9

本软件为空壳播放器，不内置任何影视内容，需自行配置合法内容源，请遵守当地法律法规。

总结

· FongMi 影视：设置 → 缓存，一键清除，已包含接口 jar 缓存；
· takagen99 版：首页单击左上角应用名称清缓存并删除 jar 缓存，长按只重载；
· 从缓存加载jar失败：jar 缓存损坏或不兼容，先删 jar 缓存，再"清除数据"重填配置；系统"清除缓存"清不掉 files/csp 里的 jar。

你遇到过哪些清缓存才能解决的问题？欢迎在本帖补充。