Rspamd历史记录功能异常问题分析与解决方案

问题背景

近期Rspamd 3.8.2版本用户报告了一个普遍性问题：在Web界面切换至历史记录(History)标签页时，系统会显示错误信息"WRONGTYPE Operation against a key holding the wrong kind of value"，导致无法正常查看历史扫描记录。该问题在多个用户环境中复现，且重启Rspamd或Redis服务均无法解决。

技术分析

错误本质

该错误属于Redis数据库的类型冲突错误，表明程序尝试对存储了错误类型值的键执行不兼容的操作。具体表现为：

1. Rspamd尝试从Redis获取历史记录数据时
2. Redis中存储的键值类型与预期不符
3. 系统抛出WRONGTYPE错误并中断操作

根本原因

经过分析，问题源于Rspamd 3.8.2版本对历史记录存储机制的调整。新版本可能改变了历史数据在Redis中的存储格式或结构，导致与旧版本存储的数据产生兼容性问题。

解决方案

方法一：清除Redis历史数据（推荐）

执行以下命令清除Redis中的历史记录数据：

echo 'DEL rs_history' | redis-cli

此方法会：

1. 完全删除旧的rs_history键
2. 让Rspamd重新创建符合新版本要求的数据结构
3. 确保后续操作不会出现类型冲突

方法二：修改键前缀配置

在local.d/history_redis.conf配置文件中修改键前缀：

key_prefix = "rs_history{{HOSTNAME}}{{COMPRESS}}";

此方法通过：

1. 使用动态生成的键名
2. 避免直接使用默认的rs_history键
3. 创建新的数据结构而不影响旧数据

注意事项

1. 清除Redis历史数据会导致所有历史记录丢失
2. 修改键前缀配置后，新旧历史记录将分别存储
3. 建议在业务低峰期执行这些操作
4. 操作前建议备份Redis数据

技术建议

对于生产环境，建议：

1. 先使用方法二进行临时修复
2. 在维护窗口期使用方法一彻底解决问题
3. 监控Redis内存使用情况，历史记录可能占用较多空间
4. 考虑设置适当的历史记录保留策略

该问题预计会在后续版本中得到官方修复，届时用户可考虑升级到修复版本。