Redisson JCache 在 Redis 6.0 环境下遇到的 EVALSHA_RO 命令兼容性问题解析

问题背景

在 Redisson 3.30.0 版本中，用户在使用 JCache 功能时遇到了一个 Redis 命令兼容性问题。错误日志显示系统尝试执行 EVALSHA_RO 命令时被 Redis 6.0.16 服务器拒绝，提示"ERR unknown command"错误。值得注意的是，这个问题在 3.29.0 版本中并不存在。

技术细节分析

1. EVALSHA_RO 命令的由来

EVALSHA_RO 是 Redis 7.0 版本引入的新命令，它是 EVALSHA 的只读版本，专门用于在集群只读副本上执行缓存的 Lua 脚本。这个命令的设计初衷是为了提高只读操作的安全性和性能。

2. 问题根源

Redisson 3.30.0 在 JCache 实现中错误地假设了 Redis 服务器支持 EVALSHA_RO 命令，而实际上用户环境运行的是 Redis 6.0.16。这导致了版本不兼容问题，因为：

• Redis 6.x 系列不支持 EVALSHA_RO 命令
• 该命令是 Redis 7.0 才引入的特性

3. 影响范围

这个问题主要影响以下使用场景：

• 使用 Redisson 3.30.0 版本
• 后端 Redis 服务器版本低于 7.0
• 启用了 JCache 功能
• 配置中设置了 useScriptCache=true

解决方案

Redisson 开发团队迅速响应并修复了这个问题。修复方案主要包括：

1. 修正了日志输出逻辑，避免误导性错误信息
2. 确保在低版本 Redis 环境中不会尝试使用 EVALSHA_RO 命令

最佳实践建议

对于使用 Redisson 连接 Redis 的用户，建议：

1. 在升级 Redisson 版本时，注意检查 Redis 服务器版本兼容性
2. 对于生产环境，建议先在小规模测试环境中验证新版本
3. 关注 Redisson 的版本发布说明，了解各版本的特性和兼容性变化
4. 如果必须使用 Redis 6.x 及以下版本，可以考虑暂时停留在 Redisson 3.29.0

总结

这个案例很好地展示了分布式系统开发中版本兼容性的重要性。作为开发者，在引入新特性时需要特别注意向后兼容性，特别是当这些特性依赖于特定版本的底层服务时。Redisson 团队快速响应并修复问题的做法也值得赞赏，这体现了成熟开源项目的维护质量。

对于用户来说，这个案例提醒我们在升级任何系统组件时都应该全面考虑依赖关系，特别是在生产环境中，谨慎的升级策略可以避免很多潜在问题。