配了源但首页还是空白：接口不通的排查清单
先确认：你是真的配好源了吗
很多新用户把粘贴了接口地址和配好源了搞混了。确认这三件事：
- 接口地址粘贴后点了保存/确定；
- 回到接口管理页，该接口的启用开关是打开的（不是灰色）；
- 保存后 TVBox真的去请求过接口（有些版本需要手动触发刷新）。
以上任何一步没做到 → 首页自然空白。
排查步骤（按可能性排序）
第一步：接口地址本身能访问吗
最直观的验证方法：用手机或盒子自带的浏览器打开你填的那个接口 URL。
| 浏览器里看到 | 结论 |
|---|---|
| JSON 文本 / m3u 文本 | 接口能访问，地址没写错，问题在 TVBox 解析这一步 |
| 404 页面 / 错误页 | 接口地址挂了，换一个 |
| 需要登录/验证码 | 接口需要鉴权，TVBox 没法自动登录，换公开接口 |
| 什么都没有（超时） | 接口服务器响应慢或网络问题 |
第二步：是不是所有源都挂了
如果你同时开了多个源但首页还是空，可能是你选的这几个源同时失效了。
快速验证：全部关掉 → 只开一个 → 刷新。逐个试，找到底哪个源是活的。
第三步：网络能通但 TVBox 请求不到
有些奇怪的情况：浏览器能打开接口 URL，但 TVBox 不行。可能原因：
- 接口屏蔽了非浏览器 User-Agent：少数源会检查请求头，TVBox 的 UA 被拒绝了；
- DNS 解析问题：TVBox 用的 DNS 和系统不同（极少数定制 ROM）；
- 代理/VPN 影响：如果你手机上开了代理/VPN，可能影响 TVBox 的网络请求。
解决：暂时关掉代理，或者换一个不检查 UA 的接口。
第四步：接口格式 TVBox 不支持
有些接口虽然返回了 JSON，但结构不符合 TVBox 能识别的 Schema。浏览器里看起来是 JSON，但 TVBox 解析不了。这种情况你自己没法修——只能换源。
第五步：清除缓存重试
TVBox 可能缓存了之前请求失败的结果：
- 进入设置；
- 找到「清除缓存」或「清除数据」选项；
- 清完重启 TVBox；
- 回到首页看有没有变化。
注意：清缓存不会丢收藏和历史（清「应用数据」才会）。
还是不行怎么办
如果五步都走完还是空白：
- 换一个全新的接口地址——可能你手里那几个源全挂了；
- 换一个 TVBox 分支——影视仓、OK影视等可能对某些源的兼容性更好；
- 放弃源的方向，改用 m3u 直播源验证 TVBox 本身能不能工作——如果直播能加载出频道列表，说明 TVBox 没问题，问题在你找的点播源。
下一页
源终于加载出来了，但点进剧集后播放失败。接着看播放失败排查。