EPG 节目单空白或不全：源、匹配与刷新的检查清单

频道能播，节目预告却是空的、或缺了一大半——EPG 的问题不影响看，但影响用。空白的原因集中在四个点，按顺序核对。

检查一：源挂上、拉到了吗

• 应用里确认 EPG 源条目存在且地址正确（挂载方法见挂节目单源）
• 拉取需要时间：XMLTV 文件动辄几 MB 到几十 MB，第一次加载可能要等上一会儿，别两分钟就判死刑
• 手动触发一次 EPG 更新（设置里的更新入口），排除「更新周期还没到」的等待

检查二：频道号匹配吗

部分频道有节目、部分没有——这是典型的匹配问题，不是源的问题：

• 节目单按频道号（tvg-id）与你的列表对号（原理见频道号匹配）
• 没节目的频道，核对它的 tvg-id 写法与节目单源里的写法是否一致
• 自己的列表自己修 id；别人的列表，个别频道没节目属于源覆盖范围问题，接受或反馈维护方

检查三：时间偏移了吗

节目单有内容但时间不对——全部频道整体差固定的几个小时，是时区偏移，调整方法见时间偏移。注意先确认设备系统时间本身是对的。

检查四：该刷新了吗

节目单是滚动数据，停更的表现是「今天的节目单还是昨天的」：

• 手动更新一次看日期是否推进
• 长期停更 → 节目单源本身停摆，换源或反馈

全空的另一种可能

JTV 老格式源失效：个别老列表配的 JTV 节目单早已停止维护，拉下来的文件是空壳。新配置换 XMLTV 源，理由见JTV 老格式。

按四步查完仍空白的，说明节目单源本身有问题——它和列表一样是第三方数据，等维护方修，或参考列表更新换一份源。