Redis集群中ioredis调用Lua函数偶现非本地键错误的排查与解决

• Redis集群基于哈希槽分片，每个主节点仅负责一部分槽位对应的键，你的目标有序集合仅存储在某一个特定主节点上。
• 你调用fcall时传入的第二个参数是"0"，表示未指定任何键参数，ioredis客户端会随机选择一个主节点发送请求：
  • 当请求恰好落到存储目标有序集合的节点时，脚本能正常访问本地键，返回结果；
  • 当请求落到其他节点时，脚本尝试访问不属于该节点的键，触发Redis集群的脚本键检查机制，抛出ERR Script attempted to access a non local key错误。

要让请求稳定路由到正确节点，必须遵循Redis集群的路由规则，明确指定脚本要操作的键：

1. 调整Lua脚本的参数结构：确保脚本要操作的有序集合键通过KEYS数组传入（Redis要求脚本中访问的键不能硬编码，必须放在KEYS参数里）。将脚本中硬编码的有序集合键名替换为KEYS[1]，示例：

   -- 原硬编码写法
   -- zrange "target_zset" 0 -1
   -- 修改为
   zrange KEYS[1] 0 -1
   

2. 修改Node.js的fcall调用：将目标有序集合键作为参数传入，同时把键的数量参数（第二个参数）改为"1"：

   -- 假设你的有序集合键名为"target_zset"
   cluster.fcall("myFunc", "1", "target_zset", "arg1", "arg2", "arg3").then((elements) => {
     console.log(elements);
   });
   

   这样ioredis会根据target_zset的哈希槽计算出对应的节点，将请求精准发送到存储该键的主节点，脚本就能访问本地键，不会再出现跨节点访问的错误。

3. 可选：补充错误捕获：为避免未处理的Promise拒绝，建议给调用添加catch块：

   cluster.fcall("myFunc", "1", "target_zset", "arg1", "arg2", "arg3")
     .then((elements) => {
       console.log(elements);
     })
     .catch((err) => {
       console.error("调用失败:", err);
     });
   

内容的提问来源于stack exchange，提问作者RRM