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

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

2025-06-26 09:18:42作者:段琳惟

问题现象

在使用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的适配方案,以保持整个媒体管理生态的稳定性。

登录后查看全文
热门项目推荐
相关项目推荐