Node.js调用Redis auth()时出现Cannot destructure 'username'错误

问题原因 #

你遇到的错误源于两个问题：

1. 当通过url参数传入包含认证信息的Redis连接字符串时，v4.x客户端会自动解析用户名、密码并完成认证流程，无需手动调用auth()。无参数调用auth()会触发内部逻辑尝试解构未定义的认证配置对象，从而抛出该错误。
2. 你的代码缺少v4.x客户端必需的connect()调用，这是建立连接的核心步骤。

修正方案 #

移除手动的auth()调用，添加connect()方法触发连接流程，修改后的代码如下：

const { createClient } = require('redis');

const redisClient = createClient({
  url: config.redis.url, // 连接字符串已包含认证信息，客户端会自动处理
});

const connectRedis = async () => {
  try {
    await redisClient.connect(); // 显式建立连接
    console.log('Redis连接成功');
  } catch (error) {
    console.error('Redis连接失败:', error);
  }
};

connectRedis();

// 可选：监听全局错误事件，及时捕获运行时异常
redisClient.on('error', (err) => {
  console.error('Redis客户端异常:', err);
});

额外说明 #

如果后续需要手动执行认证（比如连接字符串未包含认证信息），需给auth()传入完整参数：

await redisClient.auth({ username: 'default', password: 'myPassword' });

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