node-redis连接AWS ElastiCache Redis Cluster读写报MOVED错误

问题复现条件 #

• 客户端环境：Node.js 环境使用 v4.0.1 版本的官方 redis 客户端包
• 现象表现：
  • 客户端可正常建立连接，执行PING命令返回PONG
  • 执行GET/SET等键读写操作时，固定抛出Error MOVED 12218 ip:6379错误
  • 参考公开issue方案调整后问题仍复现
• 初始问题代码：

import {createClient} from "redis";
const client = createClient({url: "redis://xyz.abc.clustercfg.use2.cache.amazonaws.com:6379"});
await client.connect();
console.log("client connected");
console.log(await client.ping());

根因分析 #

MOVED是Redis Cluster原生的槽位重定向响应：Redis Cluster将全量键分散到16384个哈希槽中，由不同节点分别负责一部分槽位，当客户端向错误的节点发送键操作请求时，节点会返回MOVED响应，告知当前请求对应的键实际所属的节点地址。
出现该错误的核心原因是客户端未以集群模式初始化，无法自动处理槽位重定向逻辑：

• 你当前使用的createClient方法是单机模式的初始化入口，该模式下客户端不会缓存集群槽位映射表，收到MOVED响应后不会自动跳转请求到正确节点，直接抛出错误
• PING命令不涉及具体哈希槽，路由到任意节点都可以正常响应，因此会出现连通性测试正常、键操作报错的现象
• v4.x版本redis客户端的集群API和旧版本不兼容，旧版本在createClient配置中加cluster: true的写法在v4版本中完全不生效，这也是参考旧方案调整后问题仍存在的常见原因。

修复方案 #

使用v4版本专门的集群初始化方法createCluster替换单机模式的createClient，修正后代码如下：

import { createCluster } from "redis";

const clusterClient = createCluster({
  rootNodes: [
    {
      url: "redis://xyz.abc.clustercfg.use2.cache.amazonaws.com:6379"
    }
  ]
});

// 绑定错误监听避免未捕获异常
clusterClient.on('error', (err) => console.error('Redis Cluster Error', err));

await clusterClient.connect();
console.log("cluster connected");
console.log(await clusterClient.ping());
// 后续所有GET/SET等操作都调用clusterClient实例即可，客户端会自动处理槽位路由，不会再抛出MOVED错误

开启集群模式后仍报错的排查点 #

• 网络连通性校验：确认客户端运行环境可以正常访问ElastiCache集群所有分片节点的6379端口，关联的安全组、网络ACL没有拦截对应流量
• 访问地址校验：如果是跨VPC、公网环境访问集群，确认集群节点返回的IP/域名是客户端可直接访问的地址，必要时配置节点地址映射规则
• 版本兼容校验：v4.0.1属于v4系列早期版本，存在少量集群模式兼容问题，可升级到v4系列最新稳定版后重试

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