Turms项目中Redis阻塞列表过期清理机制的Bug分析与修复

在Turms即时通讯服务器的开发过程中，我们发现了一个关于Redis阻塞列表管理的潜在问题。这个问题涉及到服务器对过期客户端处理机制的有效性，值得开发者们深入了解。

问题背景

Turms使用Redis来管理被阻塞的客户端列表，其中包含两个关键组件：

1. BlocklistServiceManager：负责编码被阻塞客户端的解封时间
2. evict_expired_blocked_clients.lua：Lua脚本负责清理过期的被阻塞客户端

问题本质

问题的核心在于时间单位的不一致：

• BlocklistServiceManager使用毫秒级时间戳来记录客户端的解封时间
• 而Lua脚本却以秒为单位进行比较和清理

这种单位不一致导致脚本无法正确识别和清理已过期的被阻塞客户端，使得Redis中可能积累大量实际上已经应该被解封的客户端记录。

技术影响

这个bug会导致：

1. Redis内存使用效率降低，因为过期记录未被及时清理
2. 系统可能错误地维持对已解封客户端的限制
3. 阻塞列表管理功能的部分失效

解决方案

修复方案很简单但很关键：

1. 统一使用毫秒或秒作为时间单位
2. 确保BlocklistServiceManager和Lua脚本使用相同的时间精度

在最新版本的Turms中，这个问题已经得到修复，开发者可以通过更新代码或Docker镜像来获取修复后的版本。

最佳实践建议

在处理分布式系统中的时间相关功能时，建议：

1. 明确文档记录所有时间参数的单位
2. 在系统设计时统一时间精度标准
3. 对跨组件的时间处理进行充分的单元测试
4. 考虑使用专门的日期时间库来处理时间转换

这个案例提醒我们，在分布式系统开发中，即使是简单的时间单位问题也可能导致功能异常，需要开发者保持警惕。