Sonarr通知系统配置问题解析：OnDownload与OnImportComplete的关联机制

问题背景

在Sonarr 4.0.6版本中，用户反馈在启用"On Import Complete"（导入完成时）通知后，仍然会收到"On Download"（下载完成时）的通知。这源于Sonarr通知系统的一个历史遗留问题，该问题在之前的版本中已被部分修复但仍有配置残留。

技术原理

Sonarr的通知系统经历了以下演进过程：

1. 旧版本中存在三个独立通知触发点：

   • On Download（下载完成时）
   • On Import（导入时）
   • On Upgrade（升级时）

2. 新版本进行了语义重构：

   • "On Import"重命名为"On File Import"（文件导入时）
   • "On Upgrade"重命名为"On File Upgrade"（文件升级时）
   • "On Download"选项从UI中移除

问题本质

该现象的核心原因是：

1. 旧配置在升级时被保留
2. 新UI隐藏了部分选项但未清理底层配置
3. 通知系统的前后端配置存在不一致

解决方案

对于遇到此问题的用户，建议采取以下步骤：

1. 完全禁用"On File Import"通知
2. 仅保留"On Import Complete"通知
3. 检查通知服务的API请求确认无冗余配置

最佳实践

1. 版本升级后应全面检查通知配置
2. 对于Pushover等通知服务，建议：
   • 清理历史配置
   • 重新创建连接设置
3. 定期验证通知行为是否符合预期

系统设计启示

这个案例反映了配置管理系统中的常见问题：

1. 功能迭代时需要考虑配置迁移
2. UI隐藏选项不等于配置清理
3. 需要完善的配置版本兼容机制

建议开发者在类似场景中：

1. 实现配置自动迁移脚本
2. 提供配置清理工具
3. 确保UI与底层配置的严格同步