FreshRSS过滤功能异常排查与日期参数使用指南

问题现象与初步分析

在Ubuntu Server 24 LTS系统上部署的FreshRSS 1.25.1-dev版本中，用户报告了两个关键问题：

1. 时间范围过滤器（如date:P1W）失效，系统返回了全部文章而非最近一周内容
2. 系统日志出现"filters does not exist in configuration"错误提示

该环境采用Apache 2.4.58作为Web服务器，PHP 8.3.6运行环境，MariaDB 10.11.8作为数据库后端。值得注意的是，安装检查显示所有组件均正常，但过滤功能仍出现异常。

问题排查过程

通过检查Git版本控制状态，发现用户使用的是edge分支（commit afb6f788）。这个开发分支可能存在不稳定性，特别是对于过滤功能的实现。技术团队尝试复现但未能成功，最终用户通过重新安装解决了问题，这表明可能是：

• 安装过程中配置文件未正确生成
• 数据库初始化时过滤器相关表结构未完整创建
• 缓存数据与当前版本不兼容

FreshRSS日期过滤参数详解

在问题解决过程中，延伸出关于日期过滤器的技术讨论，这里特别说明两个关键参数的区别：

1. date:PT24H

   • 作用：筛选过去24小时内被FreshRSS接收/发现的文章
   • 可靠性：高，基于系统实际获取时间
   • 适用场景：标记"已读"操作时最安全的选择

2. pubdate:PT24H

   • 作用：基于文章元数据中的发布时间进行筛选
   • 风险：可能存在时间戳异常（如未来日期或历史日期）
   • 注意事项：不适用于精确的新文章筛选，仅建议在了解数据源质量时使用

最佳实践建议

1. 生产环境建议使用stable分支而非edge分支
2. 执行重要操作前先测试过滤器效果
3. 对于时间敏感操作优先使用date参数
4. 重新安装后需检查所有自定义过滤器是否生效

总结

本次案例展示了开源软件在开发分支可能存在的兼容性问题，也体现了良好的问题排查流程。日期过滤器作为FreshRSS的核心功能，正确理解其参数差异对内容管理至关重要。建议用户在复杂过滤条件实施前，先通过小范围测试验证效果。