全部指南

EPG 故障排查

电视节目指南(EPG)为空或不正确:排查 M3U 与 XMLTV

系统地诊断节目缺失、时间偏移以及节目对应到错误频道等问题。

由 DringTV 技术团队撰写并验证 · 更新于 2026 年 8 月 1 日 · 8 分钟阅读

简要回答

正确的 EPG 需要链条上的三个环节同时成立:可访问的 XMLTV 来源、播放列表与 XMLTV 文件中相同的频道标识符,以及正确的时间处理。请按此顺序逐级检查,而不是反复刷新应用。

要点

  • 播放与节目数据是两种相互独立的资源。
  • 播放列表中的 tvg-id 必须与 XMLTV 中的频道 id 一致。
  • 所有节目统一偏移通常说明存在时区或时差偏移问题。
  • 切勿在论坛或截图中公开私有的 XMLTV URL。
01

节目指南链条的三个环节

播放列表描述媒体条目,XMLTV 描述频道及其节目。播放器必须通过稳定的标识符将两者对应起来,再把节目时间换算为设备所在时区。

仅靠显示名称是不够的。两个不同的名称可以通过同一个技术 id 匹配成功,而名称完全相同的条目也可能因 id 不同而匹配失败。

02

五分钟快速诊断

  1. 先确认该媒体条目可以正常播放;如果无法播放,首要问题就不是 EPG。
  2. 检查播放列表是否通过 url-tvg 声明了节目指南,或来源所有者是否单独提供了授权的 XMLTV URL。
  3. 在浏览器中只检查 URL 的域名,不要暴露完整的私有地址或参数。
  4. 刷新播放列表和节目指南,然后等待同步完成。
  5. 将播放列表中的某个 tvg-id 与 XMLTV 中对应的频道 id 进行比对。
03

根据症状判断

症状可能原因有效检查
所有频道都没有节目XMLTV 缺失、无法访问或为空声明的地址、网络状态、文件大小和日期
只有部分条目为空tvg-id 缺失或不匹配标识符是否完全一致
所有节目都有时间偏移来源的时区或时差偏移有误XMLTV 时间、设备时区和夏令时
节目显示在错误的条目上映射重复或错误频道 id 和 tvg-id 是否唯一
几天后节目指南变空XMLTV 不再更新或缓存已过期最后一条节目的日期和刷新频率
04

播放器能修复什么、不能修复什么

播放器可以下载、缓存、索引并显示收到的数据。它可能会根据名称推测部分匹配关系,但推测有可能把两个不同的频道错误地关联在一起。

播放器无法凭空生成缺失的节目,也无法永久修正来源中不一致的 id。可靠的解决办法是由合法的来源管理员修正播放列表或 XMLTV 文件。

05

一份有用的问题报告应包含哪些信息

  • 来源类型:M3U、Xtream Codes 或 Stalker/Ministra。
  • 受影响条目的大致数量(不要暴露私有内容)。
  • 观察到的时间偏移量和设备时区。
  • 应用版本和设备型号。
  • 最后一次成功刷新的时间。
  • 切勿附上 URL、密码、令牌、MAC 或含有凭据的截图。

常见问题

为什么没有节目指南也能正常播放?

播放地址和节目数据是相互独立的资源。其中一个可以正常使用,而另一个可能缺失或已过期。

修改电视的时区一定能解决时间偏移吗?

只有在设备时区设置错误时才有效。如果 XMLTV 中的时间本身编码错误,就必须修正来源数据。

技术参考资料

在专为电视设计的界面中实践这些原则

价格 · 首页