Node.js连接Google Cloud VM上Redis服务器遇ECONNREFUSED错误求助

核心问题定位 #

从错误信息里的address: '::1'可以明确看出，你的Node.js应用实际在尝试连接本地回环地址（IPv6的localhost），而非你预期的Google Cloud VM外部IP。这说明代码中配置的redisIP变量并未生效。

可能的原因及解决方法 #

• redisIP变量未正确赋值
  检查代码中redisIP的定义，确认它确实被设置为VM的外部IP（比如'123.123.123.123'），而非'localhost'、'::1'或未定义（部分Redis客户端会默认连接本地）。

• Redis客户端版本的配置格式差异
  若使用redis@4.x及以上版本，旧版的host/port直接配置的方式已失效，需放到socket对象中，或采用URL格式：

  // 方式1：使用socket配置
  this.client = redis.createClient({
    socket: {
      host: redisIP,
      port: 6379,
      connectTimeout: 3000
    }
  });
  
  // 方式2：使用URL格式
  this.client = redis.createClient(`redis://${redisIP}:6379`);
  

  旧配置格式在新版客户端中会被忽略，导致客户端默认连接本地。

• 环境变量/配置加载异常
  若redisIP从环境变量读取，确认环境变量已正确设置且被代码读取到。可在连接前添加日志验证：

  console.log('当前Redis IP:', redisIP); // 检查输出是否为VM外部IP
  

快速验证步骤 #

1. 在连接代码前打印redisIP的值，确认其符合预期；
2. 若使用新版Redis客户端，切换到socket配置格式重试；
3. 直接将VM外部IP硬编码到配置中测试，排除变量赋值问题。

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