Rspamd 3.8.0版本中Redis学习任务失败的故障分析与解决方案

问题背景

近期Rspamd升级至3.8.0版本后，多个用户报告出现无法执行学习任务的问题。系统日志中显示Redis脚本执行时出现"stack overflow"错误，提示"too many return values at once"。该问题同时影响自动学习和手动学习功能，且在不同Redis版本（5.0-7.0）和操作系统环境中均有出现。

技术分析

根本原因

经过深入分析，发现问题源于Rspamd 3.8.0对MessagePack序列化机制的优化。新版本假设Redis键名均为短字符串，但在实际使用中，特别是当配置了per_user域分类器时，键名前缀可能变得较长。这种长度假设的不匹配导致MessagePack序列化时产生栈溢出错误。

影响范围

该问题主要影响以下配置场景：

1. 使用Redis作为贝叶斯分类器后端
2. 启用了per_user配置（按用户/域名分类）
3. 使用非默认的长键名前缀

错误表现

系统日志中典型错误信息包括：

cannot learn task: ERR Error running script: stack overflow (too many return values at once)
cannot classify task: ERR Error running script: stack overflow

解决方案

临时缓解措施

对于急需恢复功能的用户，可考虑以下临时方案：

1. 回退至Rspamd 3.7.x版本
2. 临时禁用贝叶斯学习功能

永久修复

开发团队已提交修复补丁，主要修改内容包括：

1. 移除对Redis键名长度的假设
2. 优化MessagePack序列化处理逻辑
3. 增强对长前缀键名的兼容性

最佳实践建议

1. 配置检查：升级前应检查classifier-bayes配置，特别是per_user相关设置
2. 测试验证：在生产环境部署前，建议在测试环境验证学习功能
3. 监控机制：建立对Redis脚本执行状态的监控，及时发现类似问题

总结

Rspamd 3.8.0的Redis集成问题展示了底层假设与实际使用场景间的潜在差异。该问题的修复不仅解决了当前的学习功能异常，也为系统处理复杂键名场景提供了更好的健壮性。建议用户在升级后密切关注学习功能的运行状态，必要时参考官方文档调整配置。

注：本文基于社区反馈和开发团队分析编写，具体实施时请结合自身环境特点进行评估。