Jellyfin Android TV客户端播放卡顿问题排查与解决方案
项目地址: https://gitcode.com/gh_mirrors/je/jellyfin-androidtv 问题现象分析
近期部分Jellyfin Android TV客户端用户（版本0.17.8）反馈在播放视频时出现周期性卡顿现象：视频开始播放后约2秒即出现冻结，持续约1分钟后短暂恢复，随后再次进入冻结状态。值得注意的是，该问题仅出现在Android TV客户端，Web浏览器端和手机客户端均表现正常。
技术排查要点
-
播放行为记录分析
从服务器日志可见，播放开始时正常触发了PlaybackReporting插件的计时记录（ItemType=Movie），但后续出现了WebSocket连接异常提示："Lost 1 WebSockets"。这表明客户端与服务器间的长连接存在不稳定性。 -
网络层诊断
深入分析后发现，问题的根源在于TV设备的WiFi连接存在间歇性中断。即使表面显示已连接，实际网络传输质量不稳定，导致：- 媒体流传输中断
- 播放状态心跳包丢失
- WebSocket长连接超时断开（每20秒的KeepAlive检测失败）
-
客户端表现差异
其他客户端正常的原因可能包括：- 手机客户端通常使用更积极的缓冲策略
- Web浏览器可能启用了不同的传输协议
- TV设备的网络芯片组对WiFi信号波动更敏感
解决方案验证
最终通过以下方式确认并解决问题：
- 改用有线网络连接后播放完全正常
- 对比测试发现TV设备的WiFi模块存在驱动级问题
- 临时解决方案包括：
- 使用5GHz频段减少干扰
- 调整路由器MTU值
- 更新TV设备固件
最佳实践建议
对于Android TV客户端的播放问题，建议按以下步骤排查：
- 优先检查物理层连接（有线/无线信号强度）
- 观察服务器FFmpeg.Remux日志（本例中未提供）
- 对比不同客户端的传输协议差异
- 测试时关闭其他网络负载
该案例提醒我们，在流媒体服务问题排查时，需要建立从物理层到应用层的完整检查链路，特别是对于嵌入式设备（如智能电视）的网络模块性能要保持关注。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
