Sonarr时间同步问题导致"Added"过滤器失效的解决方案

问题背景

在使用Sonarr媒体管理工具时，用户可能会遇到一个特殊现象：基于"Added"（添加时间）条件的自定义过滤器突然停止工作。具体表现为新添加的剧集无法被"最近X天添加"的过滤器正确识别。这个问题看似是软件功能异常，实则往往与系统时间配置有关。

问题本质分析

当Sonarr的"Added"过滤器失效时，其根本原因通常在于时间不同步问题。Sonarr在计算"最近X天"的时间范围时，依赖于系统时钟。如果系统时间与实际时间存在偏差，会导致时间计算错误，进而影响过滤器的正常工作。

典型场景还原

在实际案例中，用户发现：

1. 新添加的剧集（如"Friends"）在常规视图中可见
2. 这些剧集带有正确的添加时间戳（显示为"今天"）
3. 但在"最近7天添加"的过滤视图中却无法显示

通过排查发现，该用户的Docker容器系统时间比实际时间快了2小时。这意味着：

• 当剧集刚添加时，系统认为它属于"未来时间"
• 只有当系统时间超过剧集添加时间后，才会被纳入时间范围计算
• 因此出现了2小时的"延迟显示"现象

解决方案

检查系统时间配置

1. 验证容器时间： 在宿主机执行以下命令检查容器时间：

   docker exec -it sonarr date
   

2. 检查宿主机时区：

   timedatectl
   

   确保时区设置正确（如亚洲用户通常需要设置为Asia/Shanghai）

修正时间配置

1. 宿主机时区设置：

   sudo timedatectl set-timezone Asia/Shanghai
   

2. Docker容器时间同步： 在docker-compose.yml中添加：

   environment:
     - TZ=Asia/Shanghai
   volumes:
     - /etc/localtime:/etc/localtime:ro
     - /etc/timezone:/etc/timezone:ro
   

3. 重启服务：

   docker-compose down && docker-compose up -d
   

预防措施

1. 在部署Sonarr等时间敏感服务时，应当：

   • 明确设置容器时区
   • 定期检查系统时间同步状态
   • 考虑使用NTP服务保持时间同步

2. 对于Docker环境，建议：

   • 在编排文件中显式声明时区
   • 避免使用默认时区配置
   • 对关键服务添加时间监控

技术原理深入

Sonarr的"Added"过滤器基于SQL查询实现，其核心逻辑是：

WHERE Added BETWEEN datetime('now', '-7 days') AND datetime('now')

当系统时间不准确时：

• datetime('now')会返回错误的时间值
• 时间范围计算会产生偏差
• 导致符合条件的记录被错误排除

总结