Sonarr项目中的季搜索功能未正确过滤未监控剧集问题分析

问题背景

在Sonarr媒体管理系统中，用户发现了一个关于季搜索功能的异常行为。当用户执行季搜索操作时，系统会无视剧集的监控状态，对所有剧集执行搜索，这与界面提示的"仅搜索受监控的剧集"不符。

问题现象

用户界面中季搜索按钮的提示文字明确说明该操作"仅搜索受监控的剧集"，但实际测试发现系统会为季中的所有剧集执行搜索，包括那些被标记为不受监控的剧集。这种行为会导致不必要的搜索请求，特别是对于包含大量剧集的季(如特别季Season 0)来说，会显著增加系统负担。

技术分析

通过查看Sonarr的源代码，我们发现问题的根源在于ReleaseSearchService类中的SearchSpecial方法。该方法在构建搜索查询时，会为季中的每个剧集生成搜索标题，但没有考虑剧集的监控状态。

核心问题代码如下：

searchSpec.EpisodeQueryTitles = episodes.Where(e => !string.IsNullOrWhiteSpace(e.Title))
                                        .SelectMany(e => searchSpec.CleanSceneTitles.Select(title => title + " " + SearchCriteriaBase.GetCleanSceneTitle(e.Title)))
                                        .ToArray();

这段代码仅过滤了标题为空的剧集，而没有检查剧集的Monitored属性。因此，即使某些剧集被标记为不受监控，系统仍会为它们生成搜索查询。

解决方案

正确的实现应该是在构建剧集搜索标题列表时，加入对剧集监控状态的检查。修改后的代码应如下：

searchSpec.EpisodeQueryTitles = episodes.Where(e => !string.IsNullOrWhiteSpace(e.Title))
                                        .Where(e => !monitoredOnly || e.Monitored)
                                        .SelectMany(e => searchSpec.CleanSceneTitles.Select(title => title + " " + SearchCriteriaBase.GetCleanSceneTitle(e.Title)))
                                        .ToArray();

这个修改添加了一个额外的过滤条件，确保只有当monitoredOnly为false或剧集确实被监控时，才会为该剧集生成搜索查询。

影响范围

这个问题主要影响特别季(Season 0/Specials)的搜索行为。对于常规季，系统可能已经通过其他方式限制了搜索范围，但特别季由于剧集数量多且类型多样，这个问题的影响尤为明显。

用户体验影响

当前行为会导致：

1. 不必要的搜索请求，增加系统负载
2. 可能显示用户不感兴趣的搜索结果
3. 与界面提示不符，造成用户困惑
4. 对于特别季，可能导致大量无效搜索，影响性能

最佳实践建议

对于Sonarr用户，在当前问题修复前，可以采取以下临时措施：

1. 对于不想搜索的特别季剧集，手动取消监控状态
2. 避免频繁执行季搜索操作，特别是对特别季
3. 考虑使用剧集级别的搜索替代季搜索，以获得更精确的结果

总结

Sonarr中的季搜索功能目前存在与监控状态不符的行为，特别是在处理特别季时表现明显。通过修改搜索查询构建逻辑，可以确保系统行为与界面提示一致，仅搜索用户真正关注的剧集内容。这个问题虽然不会影响数据完整性，但会影响系统性能和用户体验，值得开发者关注并及时修复。