Tvheadend与Kodi集成中的EPG事件录制失败问题深度解析

问题背景

在Tvheadend PVR后端与Kodi客户端集成环境中，用户频繁遇到即时录制失败的问题。典型表现为：当用户通过Kodi界面尝试录制EPG节目时，系统返回"User does not have access"或"server error"错误。该问题具有跨平台复现特性，影响Windows、macOS、LibreELEC等多类客户端。

技术原理分析

EPG事件生命周期

Tvheadend的EPG事件具有动态更新机制。当节目时间表发生调整时，系统会：

1. 发送eventDelete通知删除旧事件
2. 创建新事件并分配新ID
3. 通过channelUpdate通知客户端更新频道信息

问题根源

通过日志分析发现关键问题链：

1. Kodi客户端缓存了已被删除的EPG事件ID（如示例中的68845137）
2. 当用户触发录制时，客户端仍使用已失效的事件ID发起addDvrEntry请求
3. Tvheadend因事件不存在返回权限错误（安全设计使然）
4. Kodi错误处理机制将底层错误转换为用户可见的"server error"

解决方案

临时解决方案

对于具备编译能力的用户，可修改Kodi源码中的Epg.cpp：

// 修改前
if (IsTagExpired(existingTag))
// 修改后
if ((existingTag->EndAsUTC() >= CDateTime::GetUTCDateTime()) || IsTagExpired(existingTag))

该修改强制Kodi及时清理已失效的当前/未来事件缓存。

长期建议

1. 客户端优化：Kodi应改进EPG事件缓存机制，及时响应eventDelete通知
2. 服务端改进：Tvheadend可考虑区分"无权限"和"无效ID"的错误类型（需权衡安全性与诊断便利性）
3. 用户实践：录制前刷新EPG数据可降低问题发生概率

技术启示

1. 分布式系统状态同步：PVR系统需要特别注意客户端与服务端的状态一致性
2. 错误处理设计：权限系统的错误返回需要平衡安全性与可调试性
3. EPG动态性处理：广播节目时间变更在数字电视系统中十分常见，客户端需具备强健的适应性

该案例典型展示了媒体中心系统中，底层服务与客户端交互时的边界情况处理重要性。理解EPG事件的生命周期管理机制，有助于开发者构建更稳定的PVR解决方案。