Bazarr项目同步Sonarr时唯一约束冲突问题解析

问题现象

在使用Bazarr 1.4.1与Sonarr 4.0.1.929进行同步时，系统报告了SQLite数据库的唯一约束冲突错误。错误信息显示Bazarr无法插入特定剧集数据，因为table_shows.sonarrSeriesId字段违反了唯一性约束。

典型错误示例如下：

UNIQUE constraint failed: table_shows.sonarrSeriesId

问题根源

这种错误通常发生在以下场景中：

1. Sonarr数据重建：当用户重建Sonarr数据库后，原有的系列ID可能被重新分配
2. Bazarr数据库未同步更新：Bazarr保留了旧的Sonarr系列ID记录，导致新同步时出现冲突
3. 配置迁移不当：在升级或重新安装Bazarr时，直接复制了旧的配置文件而未清理数据库

技术原理

Bazarr使用SQLite数据库存储媒体信息，其中sonarrSeriesId字段被设计为唯一键(UNIQUE constraint)。这个字段与Sonarr中的系列ID保持同步。当Sonarr重建后生成的新ID与Bazarr数据库中已存在的ID冲突时，就会触发此错误。

解决方案

完整解决方案

1. 停止Bazarr服务
2. 清理数据库文件：
   • 删除Bazarr配置目录下的db子目录内容
   • 路径通常为config/db/
3. 重新启动Bazarr
4. 重新配置：
   • 语言配置文件需要重新创建
   • 为系列和电影重新分配语言配置
   • 重新设置通知服务

注意事项

1. 数据一致性：确保Sonarr和Radarr的数据稳定后再同步到Bazarr
2. 升级策略：大版本升级时建议全新安装而非配置迁移
3. 备份重要配置：清理前备份自定义的语言配置等关键信息

预防措施

1. 避免ID重用：不要将Bazarr实例与重建后的Sonarr/Radarr实例混用
2. 完整迁移：当重建Sonarr/Radarr时，应同时重建Bazarr
3. 版本兼容性：保持Bazarr与Sonarr/Radarr的版本兼容性

总结

Bazarr与Sonarr间的同步问题主要源于数据库ID的唯一性约束冲突。通过理解两者的数据关联机制，采取正确的数据库清理和重建方法，可以有效解决此类问题。对于生产环境，建议在媒体服务器重大变更时同步考虑Bazarr的适配方案，以保持整个媒体管理生态的稳定性。