Radarr数据库完整性错误分析与修复指南

问题现象

Radarr在启动过程中出现了一个关键错误，导致服务无法正常运行。错误日志显示系统抛出了一个KeyNotFoundException异常，提示字典中不存在键值为'4'的记录。这个错误发生在尝试加载电影数据时，具体是在MovieRepository类的All方法中。

错误分析

从技术角度来看，这个错误表明Radarr在尝试访问一个不存在的质量配置文件ID。错误发生在以下场景：

1. Radarr启动时尝试加载所有电影数据
2. 在关联查询中，系统发现某部电影的QualityProfileId字段值为4
3. 但在质量配置文件字典中查找ID为4的条目时失败

核心SQL查询显示Radarr执行了一个三表联查：

SELECT "Movies".*, "MovieFiles".*, "MovieMetadata".*
FROM "Movies"
LEFT JOIN "MovieFiles" ON ("Movies"."MovieFileId" = "MovieFiles"."Id")
LEFT JOIN "MovieMetadata" ON ("Movies"."MovieMetadataId" = "MovieMetadata"."Id")

根本原因

经过深入分析，这个问题通常由以下情况引起：

1. 数据库不一致：质量配置文件被删除，但仍有电影引用该配置
2. 直接数据库操作：通过非Radarr界面直接修改数据库导致引用关系破坏
3. 迁移问题：从SQLite迁移到PostgreSQL过程中数据转换不完整

在具体案例中，用户确认问题是由于添加后又删除了"Despicable Me 4"电影，但数据库中没有完全清理干净，留下了不完整的记录。

解决方案

诊断步骤

1. 首先确认质量配置文件表中有哪些有效ID：

SELECT "Id" FROM "QualityProfiles";

2. 查找引用无效质量配置的电影：

SELECT "Id", "Title", "QualityProfileId" FROM "Movies" 
WHERE "QualityProfileId" NOT IN (SELECT "Id" FROM "QualityProfiles");

修复方法

1. 更新引用：将无效引用更新为现有质量配置ID

UPDATE "Movies" 
SET "QualityProfileId" = [有效ID] 
WHERE "QualityProfileId" = 4;

2. 删除无效记录：如果确定是残留数据，可以安全删除

DELETE FROM "Movies" WHERE "Id" = [问题电影ID];
DELETE FROM "MovieMetadata" WHERE "Id" = [对应元数据ID];

预防措施

1. 避免直接数据库操作：除非必要，不要绕过Radarr界面直接修改数据库
2. 谨慎使用第三方工具：使用如recyclarr等工具时要确认其操作不会破坏数据完整性
3. 定期备份：在进行重大操作前备份数据库
4. 版本兼容性：确保Radarr版本与PostgreSQL版本兼容

技术建议

对于使用PostgreSQL的用户，建议：

1. 考虑添加外键约束来防止这类引用完整性问题
2. 实施数据库触发器在删除质量配置前检查引用
3. 定期执行数据库完整性检查脚本

这个案例展示了数据库引用完整性的重要性，也提醒我们在设计系统时要考虑健壮的错误处理机制，特别是在处理外部数据源时。