🚀 博主介绍：大家好，我是无休居士！一枚任职于一线Top3互联网大厂的Java开发工程师！ 🚀

🌟 在这里，你将找到通往Java技术大门的钥匙。作为一个爱敲代码技术人，我不仅热衷于探索一些框架源码和算法技巧奥秘，还乐于分享这些宝贵的知识和经验。

💡 无论你是刚刚踏入编程世界的新人，还是希望进一步提升自己的资深开发者，在这里都能找到适合你的内容。我们共同探讨技术难题，一起进步，携手度过互联网行业的每一个挑战。

📣 如果你觉得我的文章对你有帮助，请不要吝啬你的点赞👍分享💕和评论哦！ 让我们一起打造一个充满正能量的技术社区吧！

---

---

集群架构中Lua脚本的限制

• 为了保证Lua执行的原子性，Lua命令不可拆分，只能在集群架构的一个DB分片上执行。通常会根据Key来决定路由到哪个DB分片执行，所以在集群架构中执行Lua命令时至少需要指定一个Key。如果读写多个Key，则同一个Lua脚本中的Key必须属于同一个Slot，否则会导致执行结果异常。对于KEYS、SCAN、FLUSHDB等无Key的命令，虽然能正常执行，但返回结果只包含单个分片的数据。上述限制由Redis Cluster架构导致。
• 对单个节点执行SCRIPT LOAD命令时，不保证将该Lua脚本存入至其他节点中。

Redis Cluster 架构限制具体错误码和原因请参见下表

错误码分类

错误码	说明
-ERR for redis cluster, eval/evalsha number of keys can't be negative or zero\r\n	执行 Lua 脚本时必须带有至少一个键，代理会根据键决定将 Lua 脚本转发到哪个 DB 分片上执行。
-ERR 'xxx' command keys must in same slot	Lua 脚本中的多个键必须属于同一个槽位。

具体示例

1. 必须带有至少一个键

错误示例：

EVAL "return redis.call('get', 'foo')" 0

错误码：

-ERR for redis cluster, eval/evalsha number of keys can't be negative or zero\r\n

说明：
执行 Lua 脚本时必须带有至少一个键，代理会根据键决定将 Lua 脚本转发到哪个 DB 分片上执行。

正确示例：

EVAL "return redis.call('get', KEYS[1])" 1 fooeval

说明：
这里指定了一个键 fooeval，代理会根据这个键将 Lua 脚本转发到相应的 DB 分片上执行。

2. 多个键必须属于同一个槽位

错误示例：

EVAL "return redis.call('mget', KEYS[1], KEYS[2])" 2 foo foobar

错误码：

-ERR 'mget' command keys must in same slot

说明：
Lua 脚本中的多个键必须属于同一个槽位。在这个示例中，foo 和 foobar 可能不在同一个槽位上，因此会报错。

正确示例：

EVAL "return redis.call('mget', KEYS[1], KEYS[2])" 2 foo {foo}bar

说明：
这里使用了哈希标签 {foo}，确保 foo 和 {foo}bar 都属于同一个槽位，从而避免跨槽位操作。

总结

通过上述表格和示例，你应该能够更好地理解在 Redis Cluster 模式下使用 Lua 脚本时需要注意的事项。特别是：

1. 必须带有至少一个键：确保 Lua 脚本中至少有一个键，以便代理可以根据键将脚本转发到正确的 DB 分片。
2. 多个键必须属于同一个槽位：使用哈希标签确保多个键属于同一个槽位，避免跨槽位操作。

乐于分享和输出干货的WXGZG：JavaPersons