私有EKS集群同VPC下Node.js应用无法连接ElastiCache Redis求助

1. 客户端配置校验 #

• 确认Redis端点配置完全匹配ElastiCache官方给出的地址，不要额外添加http:///https://前缀、多余空格，默认端口为6379，需与配置端口保持一致
• 若ElastiCache开启了传输加密（TLS），必须在Node.js客户端配置中显式开启TLS参数：例如ioredis客户端需添加tls: {}配置项。telnet默认不校验TLS，因此telnet连通不代表非TLS的客户端配置能正常工作
• 若ElastiCache开启了密码鉴权/RBAC权限控制，确认Node.js配置中的密码、用户名参数完全正确，telnet默认不会触发鉴权校验，连通不代表鉴权配置有效

2. 应用运行环境校验 #

• 进入对应Pod执行env命令，检查应用读取的Redis连接相关环境变量是否正确，避免Deployment配置中环境变量拼写错误、值传递错误
• 在Pod内执行nslookup <ElastiCache端点地址>确认DNS解析正常，部分Node.js客户端默认强制走公网DNS解析，需显式指定内网DNS或关闭强制公网解析逻辑

3. 连接逻辑与错误校验 #

• 拉取Node.js应用的运行日志，根据报错信息定位问题：
  • 返回ECONNREFUSED：优先排查端口、TLS配置错误
  • 返回ETIMEDOUT：优先排查客户端超时配置，ElastiCache内网延迟较高场景下默认超时时间过短会触发连接失败
  • 返回NOAUTH：直接排查鉴权配置错误
• 在Pod内编写极简测试脚本验证连接，排除业务代码逻辑问题，参考脚本如下：

// 以ioredis客户端为例
const Redis = require('ioredis');
const redis = new Redis({
  host: '替换为你的ElastiCache端点',
  port: 6379,
  // 开启TLS时取消注释下一行
  // tls: {},
  // 配置密码时取消注释下一行
  // password: '替换为你的Redis密码'
});

redis.ping()
  .then(res => console.log('连接成功，返回结果：', res))
  .catch(err => console.error('连接失败，错误信息：', err));

执行node test.js查看输出，若测试脚本可正常连通，说明业务代码本身的连接逻辑存在问题。

4. 特殊场景校验 #

• 若使用的是集群模式的ElastiCache，确认Node.js客户端开启了集群模式配置，普通单节点模式的客户端无法对接集群模式的Redis实例
• 确认Node.js容器镜像未配置额外的全局代理、iptables规则，部分自定义镜像会强制转发流量到代理服务，导致内网ElastiCache访问失败

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