Jellyfin项目EFCore升级后剧集显示异常问题分析

问题背景

在Jellyfin项目进行EFCore数据库升级后，部分用户报告了一个严重的界面显示问题：在剧集视图下无法正常显示季数对应的具体剧集内容。具体表现为：

1. 季视图下所有剧集条目消失
2. 系列视图中季数海报只显示勾选标记而非剧集数量
3. 即使删除并重新扫描媒体库，问题依然存在

问题现象

受影响用户在升级到使用EFCore的Jellyfin不稳定版本后，发现以下异常行为：

• 当访问某个电视剧系列时，可以正常看到季数列表
• 点击具体季数后，季视图页面为空，没有显示任何剧集
• 在系列总览页面，每个季数的海报上原本应该显示剧集数量的位置变成了勾选标记

技术分析

经过开发团队深入排查，发现问题根源与"在播出季中显示特别集"这一配置选项有关。具体技术细节如下：

1. 配置参数影响：DisplaySpecialsWithinSeasons配置项的值直接影响查询逻辑。当该值为false时，会导致查询条件设置异常，最终返回空列表。

2. 查询逻辑缺陷：在BaseItemRepository中，过滤逻辑可能存在缺陷。理想情况下，查询应该同时检查"ParentId"和"SeasonId"列是否等于filter.AncestorWithPresentationUniqueKey，但当前实现可能没有正确处理这一逻辑。

3. 特殊集处理：该问题与之前版本中虚拟季数显示问题(issue #11575)有相似之处，都涉及到特殊集处理逻辑的缺陷。

解决方案

临时解决方案是将DisplaySpecialsWithinSeasons配置项强制设置为true。长期解决方案需要修复BaseItemRepository中的查询逻辑，确保：

1. 正确处理AncestorWithPresentationUniqueKey过滤条件
2. 完善特殊集在各种配置下的显示逻辑
3. 确保查询能同时检查ParentId和SeasonId字段

用户建议

对于遇到此问题的用户，可以采取以下措施：

1. 暂时启用"在播出季中显示特别集"选项
2. 等待官方发布包含修复的稳定版本
3. 如重新扫描媒体库，建议先备份数据库

总结

Jellyfin的EFCore升级过程中出现的这一剧集显示问题，揭示了媒体库查询逻辑中一个重要的边界条件处理缺陷。开发团队已经定位到具体代码位置，预计将在后续版本中彻底修复。该问题的解决将进一步提升Jellyfin在剧集管理和显示方面的稳定性。