Redis用Eval报command keys must be in same slot解决

最新推荐文章于 2025-11-16 22:28:32 发布
原创 最新推荐文章于 2025-11-16 22:28:32 发布 · 1.3w 阅读 · 5 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。

本文深入探讨Redis集群环境下，事务与脚本命令的执行限制及如何利用HashTag确保多个key分配至同一slot，实现数据一致性的策略。在Redis集群中，数据自动分布于16384个slot上，通过计算key进行路由分发，为保持一致性，引入了HashTag机制，仅对特定子串进行哈希计算。

这个问题是在Redis集群下才会发生的。

在Redis集群版实例中，事务、脚本等命令要求所有的key必须在同一个slot中，如果不在同一个slot中将返回以下错误信息(command keys must in same slot)

在集群下,它会将数据自动分布到不同的节点(虚拟的16384个slot)

它数据的路由分发,是通过计算key,所以只要key一样,则一定会被分到同一个slot

Redis的配置里面,有个属性叫hash_tag

beta:
  listen: 127.0.0.1:22122
  hash: fnv1a_64
  hash_tag: "{}"
  distribution: ketama
  auto_eject_hosts: false
  timeout: 400
  redis: true
  servers:
   - 127.0.0.1:6380:1 server1
   - 127.0.0.1:6381:1 server2
   - 127.0.0.1:6382:1 server3
   - 127.0.0.1:6383:1 server4

Hash Tag是用于hash的部分字符串开始和结束的标记，例如"{}"、"$$"等。

当一个key包含 hash_tag 的时候，就不对整个key做hash，而仅对 hash_tag包括的字符串做hash。

比如说我原来的Key是order_total,order_detail,然后我为了保证这两个Key能分到同一个slot,所以用{}把order包起来

即{order}_total,{order}_detail就可以了

lua在redis集群中的解决方案-- command keys must in same slot
阳光下的小树
07-09 1万+
'EVAL' command keys must in same slot 解决方案
Caused by: org.redisson.client.RedisException: ERR Client sent AUTH, but no password is set. channel
有时间可以指导毕业设计，可以私聊我。一个热爱编程的smallCuteMonkey，可以私信我
12-24 2066
Redisson启动异常
redis集群模式下使用LUA脚本注意事项 ERR ‘EVAL‘ command keys must in same slot
猛犸象
07-02 8955
今天在使用LUA脚本操作redis，传入了多个key，发现返回值一直是false，这让我很怀疑，于是开始研究这个事情。 打开redis客户端并连接上服务器，复现问题 redis.rds.aliyuncs.com:6379> eval "return {KEYS[1], KEYS[2]}" 2 '11' '22' (error) ERR 'EVAL' command keys must in same slot 查找资料说是集群的问题。 连接本机redis服务 127.0.0.1:6379> e
Redis内存释放后重用超危漏洞(CVE-2025-49844)：深度风险提示与防护指南
从零开始，掌握网络安全。提供全面的网络安全教程、攻防演练技巧和行业动态。
11-16 2581
摘要： CVE-2025-49844（RediShell）是Redis数据库首个CVSS 10.0满分漏洞，影响所有支持Lua脚本的版本（包括6.x-8.x全分支）。该漏洞由Wiz团队在Pwn2Own Berlin大赛中发现，涉及Redis Lua解释器的UAF漏洞和沙箱逃逸，攻击者可利用特制脚本获取服务器控制权。截至2025年10月底，全球仍有8500+未修复实例面临高风险。 漏洞利用链包括：认证突破→Lua脚本注入→沙箱逃逸→远程代码执行。公开PoC降低了攻击门槛，黑产已将其集成到自动化工具中。防护方案
redis lua : command keys must In same slot
摔断翅膀的鸟人
03-31 2637
redis集群中报错 command keys must In same slot，原因是集群中是用多keys的eval语句，访问的redis数据不一定在同一个slot槽中(槽就是redis数据存储的索引号或者分组号) 解决方法是：redis会默认根据key值进行计算槽索引值，而如果在每个key中加入“{xxx}”，redis集群会优先根据"{xxx}"字符串为依据计算槽索引号，可以保证操作的数...
执行lua脚本报错：ERR ‘EVAL‘ command keys must in same slot.
人生似幻化，终当归空无
09-11 4132
异常日志 org.springframework.dao.InvalidDataAccessApiUsageException: ERR 'EVAL' command keys must in same slot. channel: [id: 0x10457fd7... 原因分析 测试环境为单机版，线上环境为集群版，导致同样的lua脚本，在线上出错。 lua脚本为保证事务，传入的key必须是在同一个slot中。Redis集群引入了哈希槽的概念，一共有16348个slot，然后根据 CRC16(key) m
Predis\Response\ServerException: ERR ‘EVAL‘ command keys must in same slot
weixin_41429587的博客
04-30 947
[2021-04-30 06:04:16] local.ERROR: Predis\Response\ServerException: ERR 'EVAL' command keys must in same slot in /www/wwwroot/demo/vendor/predis/predis/src/Client.php:370 Stack trace: #0 /www/wwwroot/demo/vendor/predis/predis/src/Client.php(335): Predis\Cl
记一次事故看 Redis 开发规范
m0_69860228的博客
05-21 411
一、背景 某一天中午，收到反馈，app卡顿甚至无响应，随即监控中心报出大量慢请求。慢请求来源直指网关和 DP（集中鉴权中心）占慢请求总数的 80%以上。 二、事故处理 10 分钟，收集事故现场（thread dump，heap dump）重启网关，慢请求暂时恢复 20 分钟，定位为 darkportal 所使用的 redis 集群异常（响应时间 200ms） 30 分钟，分析 redis 和其他业务线共用，会受业务线影响，决定申请新的 redis 实例，将 dp 的 r..
阿里云redis集群使用lua脚本
mushuntaosama的博客
12-13 1万+
redis集群对lua集群的支持有限，阿里的文档描述也比较简单，没有demo，研究了好久才把单例的lua脚本修改成集群版 单例模式的lua脚本local strs = {}; local result = {}; local resultIndex = 2; -- ARGV[1]是操作集合的指令，这里对应的是正序还是倒序zrange、zrevrange -- KEYS[1]是zset的key --
aws-redis数据非实时迁移
line_on_database的博客
07-28 1966
一、背景 因为一套环境要迁移到aws redis上 二、使用工具 redis-shake 同步时候出现报错 2021/07/23 09:27:33 [PANIC] read error, please check source redis log or network [error]: EOF [stack]: 1 /Users/tongyao.lty/Work/RedisShake/src/redis-shake/common/utils.go:930 redis-shake/common.Iocop
redis(五) 集群模式---cluster模式（cluster）
仗剑执天涯的专栏
06-27 1302
3主3从的6个服务，没对主从不需要replicaof 指定，需要masterauth 密码相互授权。ClusterServersRedissonConfig 配置。ClusterLettuceRedisConfig 配置。6个节点，构成3主3从集群模式。可以在任意节点上执行。
五分钟讲透 Redis Lua脚本，以及Redis cluster集群模式下的 command keys must in same slot 解决方案 redis hash tag
热门推荐
LoveSummer
05-11 6万+
redis集群版的lua脚本，可以通过key的部分字符串hash来解决redis集群版的分布式是会根据KEY进行hash取模然后打到不同的slot，这种思想是典型的分而治之。分治，分流，降级。以上是关于lua在redis集群中的解决方案-- command keys must in same slot的主要内容。
Redis 两个list 用新的list替换老的list 以及command keys must in same slot解决办法
Fting
06-20 1119
redis list 'RENAME' command keys must in same slot
【Redis】解决集群模式下 (error) CROSSSLOT Keys in request don‘t hash to the same slot
be5yond的博客
09-09 3859
在启用集群模式的集群上创建由多密钥操作使用的密钥时，请使用哈希标签将密钥强制放入同一哈希槽中。当密钥包含“{...}”这种样式时，只有大括号“{”和“}”之间的子字符串得到哈希以获得哈希槽。 例如，密钥{user1}:myset和{user1}:myset2， 因为只有括号内的user1被用作计算哈希，所以会哈希到到相同的哈希槽。 172.31.62.135:6379> CLUSTER KEYSLOT {user1}:myset (integer) 8106 172.31.62.135:...
org.redisson.client.RedisException: ERR unknown command `EVAL`
water
04-29 4854
使用的redis版本是4.0.11，去掉redis.conf配置文件里面的：rename-command EVAL “” 重启redis集群即可 rename-command EVAL "" #bind 127.0.0.1 port 7006 protected-mode no daemonize yes cluster-enabled yes cluster-node-timeout ...
阿里云Redis开发规范
dichengyan0013的博客
09-29 2021
摘要：本文介绍了在使用阿里云Redis的开发规范，从键值设计、命令使用、客户端使用、相关工具等方面进行说明，通过本文的介绍可以减少使用Redis过程带来的问题。 一、键值设计 1. key名设计 (1)【建议】: 可读性和可管理性 以业务名(或数据库名)为前缀(防止key冲突)，用冒号分隔，比如业务名:表名:id ugc:video:1 (2)【建议】：简洁性 ...
阿里云redis对lua支持的描述
qq_14945847的博客
10-09 1324
LUA 支持 LUA 脚本放开限制，标准版-双节点、标准版-单节点支持用户直接调用。 集群版本条件性支持： 所有 key 都应该由 KEYS 数组来传递，redis.call/pcall 里面调用的 redis命令，key 的位置必须是 KEYS array， 否则直接返回 error。 "-ERR bad lua script for redis cluster, all the...
lua脚本在redis集群中执行报错--Lua script attempted to access a non local key in a cluster node...
巡山小妖008
03-26 4229
EVAL、EVALSHA命令 Redis从2.6.0版本开始提供了eval命令，通过内置的Lua解释器，可以让用户执行一段Lua脚本并返回数据。因为Redis单线程模型的特点，可以保证多个命令的原子性(因为最近的项目需要用到简单的分布式锁，所以会用到lua来释放锁) 脚本性能 Redis保证了脚本执行的原子性，所以在当前脚本没执行完之前，别的命令和脚本都是等待状态，所以一定要控制好脚本...
redis.exceptions,ResponseError: wrong number of arguments for ‘ pop‘ command问题解决
ashengz的博客
12-06 1711
redis6.2以下都不支持rightPop(key, count)和leftPop(key, count)语法；只支持单条取的rightPop(key)和leftPop(key)使用redis-server -v 可以查看到ubuntu系统redis的版本号。我的版本是4.0.9的，因此不可以这样使用。
lua redis（）command arguments must be strings or inteegers
最新发布
12-24
<think>我们正在解决一个具体的错误：Redis执行Lua脚本时报错“Lua redis() command arguments must be strings or integers”。这个错误通常是因为传递给Redis命令的参数类型不正确，Redis要求参数必须是字符串或整数类型。 根据引用[1][2][3]中的信息，我们可以总结出以下几个可能的原因和解决方法： 1. **参数传递格式问题（在命令行中执行脚本时）**： - 在Linux命令行中使用`redis-cli --eval`执行Lua脚本时，需要正确分隔键和参数。键和参数之间用逗号分隔，并且逗号前后必须有空格。 - 例如：`redis-cli --eval script.lua key1 key2 , arg1 arg2` - 错误示例（引用[1]和[3]）：没有空格导致错误。 2. **在Lua脚本内部，传递给redis.call/redis.pcall的参数类型问题**： - 在Lua脚本中，调用Redis命令时，每个参数都必须是字符串或整数。如果传递了其他类型（比如table、nil、boolean等），就会报错。 - 引用[2]中的例子：`ZRANGE`命令返回的是一个table（数组），然后直接将这个table作为`ZREM`命令的参数，而`ZREM`要求参数是字符串（即成员），所以出现错误。 3. **在Redis命令行中使用EVAL命令时参数传递问题**： - 使用`EVAL`命令时，需要在命令中明确指定键的数量（KEY个数），然后列出键，最后列出参数。 - 格式：`EVAL "script" numkeys key [key ...] arg [arg ...]` - 如果键的数量指定不正确，或者键和参数没有正确分隔，也会导致问题。 针对上述原因，我们提供以下解决方案： ### 1. 命令行执行脚本（使用redis-cli --eval）的正确格式 正确的命令格式为： ```bash redis-cli --eval script.lua key1 key2 ... , arg1 arg2 ... ``` 注意：逗号`,`前后必须有空格，用于分隔键和参数。键可以有多个，参数也可以有多个。 示例（引用[1]中的正确执行）： ```bash redis-cli --eval set.lua age , 18 ``` ### 2. 确保Lua脚本内参数类型正确 在Lua脚本中，确保传递给Redis命令的每个参数都是字符串或整数。如果从Redis命令返回的结果是table，而我们需要将其作为参数传递给另一个Redis命令，则必须将其转换为字符串（如果table中只有一个元素，可以取第一个元素；如果有多个，则需要遍历）。 例如，引用[2]中的错误示例： ```lua local member = redis.call('ZRANGE', KEYS[1], 0, 0) if (next(member)==nil) then return member else redis.call('ZREM', KEYS[1], member) -- 这里member是一个table（数组），而ZREM需要字符串 return member end ``` 修正：因为`ZRANGE`返回的是一个数组，即使只取一个元素（索引0到0），返回的也是一个包含一个元素的数组。所以应该取第一个元素： ```lua local members = redis.call('ZRANGE', KEYS[1], 0, 0) if next(members) == nil then return nil else local member = members[1] -- 取第一个成员 redis.call('ZREM', KEYS[1], member) return member end ``` ### 3. 在Redis命令行中使用EVAL的正确方式 在Redis命令行中，使用`EVAL`命令时，必须指定键的数量，然后依次列出键和参数，用空格分隔，不需要逗号。 示例： ```bash 127.0.0.1:6379> EVAL "return redis.call('set', KEYS[1], ARGV[1])" 1 age 18 ``` ### 4. 其他注意事项 - **字符串表示**：在Lua脚本中，即使数字也要注意，因为Lua的数字在传递给Redis命令时会被转换为字符串，这通常没问题。但是，如果期望整数参数（比如过期时间），Redis也能正确转换。 - **布尔值处理**：不要直接传递布尔值（true/false），应该转换成字符串，比如使用`tostring(true)`。 - **nil值**：避免传递nil，因为nil会导致这个错误。 ### 总结步骤 当遇到这个错误时，请按照以下步骤检查： 1. 检查命令行中参数传递格式（逗号前后空格，键和参数分隔）。 2. 检查Lua脚本中传递给`redis.call`或`redis.pcall`的每个参数，确保其类型为字符串或整数。特别注意从Redis命令返回的结果，如果是table，需要按需提取元素。 3. 在Redis命令行中使用`EVAL`时，确保键的数量正确，并正确分隔键和参数。 通过以上步骤，应该能够解决这个错误。 §§相关问题§§ 1. 在Redis Lua脚本中如何正确处理返回值为table的情况？ 2. 如何避免在Redis Lua脚本中传递错误类型的参数？ 3. 在集群环境下执行Lua脚本需要注意什么？ </think> ### 解决 Redis 执行 Lua 脚本报错：`Lua redis() command arguments must be strings or integers` 这个错误通常是由于传递给 Redis 命令的参数类型不正确引起的。以下是根本原因和解决方案： --- #### 错误原因分析 1. **参数类型不匹配** Redis 命令要求所有参数必须是字符串或整数类型，但脚本中传递了其他类型（如 boolean、table 等）[^1][^2]。 2. **命令行参数格式错误** 使用 `redis-cli --eval` 时，参数分隔符 `,` 前后缺少空格[^3]。 3. **Lua 脚本返回值问题** 脚本返回了 Redis 不支持的类型（如 nil 或 table 直接作为命令参数）[^2]。 --- #### 解决方案 ##### 1. 命令行参数格式修复 **错误格式**（逗号前后无空格）： ```bash redis-cli --eval script.lua key,arg1 redis-cli --eval script.lua key, arg1 ``` **正确格式**（逗号前后加空格）： ```bash redis-cli --eval script.lua key , arg1 # 多参数示例 redis-cli --eval script.lua key1 key2 , arg1 arg2 ``` ##### 2. Lua 脚本类型强制转换 ```lua -- 错误：直接使用可能为table的值 local data = redis.call('GET', KEYS[1]) redis.call('SET', KEYS[2], data) -- data可能是table -- 正确：显式转换为字符串 local data = redis.call('GET', KEYS[1]) if type(data) == "table" then data = data[1] -- 提取第一个元素 end redis.call('SET', KEYS[2], tostring(data)) ``` ##### 3. 处理 Redis 命令返回值 ```lua -- 错误：将ZRANGE结果直接用于ZREM[^2] local member = redis.call('ZRANGE', KEYS[1], 0, 0) redis.call('ZREM', KEYS[1], member) -- 正确：提取数组中的元素 local members = redis.call('ZRANGE', KEYS[1], 0, 0) if #members > 0 then redis.call('ZREM', KEYS[1], members[1]) -- 使用第一个元素 end ``` ##### 4. Java 代码中的类型处理（Spring Boot） ```java // 确保参数使用String序列化 redisTemplate.execute(script, redisTemplate.getStringSerializer(), null, Collections.singletonList("key"), "arg1" ); ``` --- #### 验证示例 ```lua -- test_script.lua local value = redis.call('GET', KEYS[1]) if value then return tostring(value) -- 显式转换为字符串 else return "nil" end ``` 执行命令： ```bash # 正确格式 redis-cli --eval test_script.lua mykey , ``` --- #### 关键预防措施 1. **类型检查** 在 Lua 脚本中使用 `type()` 检查变量类型 2. **显式转换** 对非字符串/整数使用 `tostring()` 或 `tonumber()` 3. **参数分隔** 遵循 `key1 key2 , arg1 arg2` 格式[^3] 4. **结果解包** 处理 Redis 返回的 table 类型时提取具体元素 > 通过上述方法可解决 95% 的此类错误。若仍存在问题，建议在 Redis CLI 中用 `EVAL` 命令逐步调试脚本。
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值