Bazarr同步Sonarr系列更新失败问题分析与解决

问题现象

在使用Bazarr与Sonarr进行集成时，用户发现当Sonarr中的系列添加新季时，Bazarr无法自动识别并同步这些新增的剧集信息。这导致Bazarr无法为这些新季剧集搜索和下载字幕。

问题分析

通过日志分析，发现根本原因是Bazarr与Sonarr的API连接出现了认证失败。具体表现为：

1. Bazarr尝试通过HTTP请求获取Sonarr的根文件夹信息时返回401未授权状态码
2. 后续尝试解析空响应体时抛出JSONDecodeError异常
3. 同步任务因此失败，导致新季剧集信息无法更新到Bazarr中

解决方案

1. 检查API密钥配置

用户需要验证Bazarr中配置的Sonarr API密钥是否与Sonarr实例当前的API密钥一致。Sonarr更新后可能会重置API密钥，导致原有配置失效。

2. 手动触发同步

在Bazarr界面中，可以通过以下路径手动触发同步：

系统 → 任务 → 强制同步Sonarr

3. 监控同步状态

建议用户定期检查：

• Bazarr的系统日志中是否有同步错误
• 系统任务列表中的同步任务执行状态
• 同步后系列信息的完整性

最佳实践

1. 定期检查集成状态：特别是在Sonarr或Bazarr更新后，应验证集成的有效性
2. 启用日志监控：配置日志监控可以及时发现同步问题
3. 测试API连接：在修改配置后，使用API测试工具验证连接性

技术原理

Bazarr与Sonarr的集成依赖于Sonarr提供的REST API。当同步任务执行时，Bazarr会：

1. 首先查询Sonarr的根文件夹信息
2. 然后获取所有系列及其剧集数据
3. 最后将这些信息与本地数据库进行比对和更新

任何一步的API调用失败都会导致整个同步过程中断。401错误通常表明认证问题，而JSON解析错误则可能是由于收到了非预期的响应内容。

总结

Bazarr与Sonarr的同步问题通常源于配置不一致或API变更。通过正确配置API密钥和定期检查同步状态，可以确保字幕下载功能正常工作。对于系统管理员而言，建立适当的监控机制可以提前发现并解决此类集成问题。