Rspamd与Apache Kvrocks兼容性优化：EVALSHA_RO命令的应用实践

背景与挑战

在现代邮件过滤系统中，Rspamd作为高性能的垃圾邮件过滤工具，常依赖Redis存储贝叶斯分类器的训练数据。然而随着数据量增长，Redis的内存限制成为瓶颈。Apache Kvrocks作为兼容Redis协议的持久化存储方案，成为理想的替代选择。但在迁移过程中，开发者发现Rspamd的贝叶斯统计功能出现兼容性问题。

核心问题分析

Rspamd通过Lua脚本执行贝叶斯统计查询时，使用EVALSHA命令加载预存脚本。该脚本本质是只读操作（仅包含SSCAN和HGET等查询指令），但在Kvrocks的副本节点上，系统会严格拒绝所有EVALSHA请求，返回"READONLY You can't write against a read only slave"错误。这与Redis副本节点允许执行只读脚本的行为存在差异。

技术解决方案

Redis 7.0引入了EVALSHA_RO命令专用于只读脚本执行。Rspamd项目团队采纳了版本感知的调用策略：

1. 新增配置项redis_version，允许用户显式声明后端存储版本
2. 当检测到Redis 7.0+或兼容存储时，自动将只读脚本调用切换为EVALSHA_RO
3. 保持对Redis 6.x及以下版本的向后兼容，继续使用传统EVALSHA

实现细节

在技术实现层面，主要修改涉及：

• 版本检测逻辑增强
• 命令分发器动态选择机制
• 贝叶斯统计模块的适配层改造

关键Lua脚本示例：

-- 优化后的统计查询脚本
local function bayes_stats_script()
    -- [原有逻辑不变]
    -- 自动适配EVALSHA/EVALSHA_RO
end

最佳实践建议

对于采用混合存储架构的用户，建议：

1. 明确配置redis_version参数
2. 测试环境充分验证读写分离场景
3. 监控脚本执行指标，确保兼容性

未来展望

随着存储生态发展，Rspamd将持续优化多后端支持：

• 完善协议版本自动协商
• 增强异构存储的容错能力
• 提供更细粒度的命令控制

该改进已随Rspamd稳定版本发布，为大规模邮件处理系统提供了更灵活的存储选择。