如何连接运行在Docker中的Redis数据库，无报错连接失败如何解决？

核心问题点 #

• Redis 官方 Node.js 客户端 v4+ 版本不会在createClient初始化后自动建立连接，必须手动调用connect()方法触发连接逻辑，这是你当前既无报错也无成功提示的核心原因：连接流程根本没有启动
• 你监听的连接成功事件名错误，v4+ 版本连接就绪的触发事件是ready，而非旧版本的open

修复后的代码示例 #

import { createClient } from 'redis'
const redisClient = createClient({ url: "redis://localhost:6379" });

redisClient.on('error', err => console.error('Redis 连接错误: ', err))
redisClient.on('ready', () => console.log("Connected to Redis"))

// 手动触发连接建立
(async () => {
  await redisClient.connect()
})()

如果是在Express初始化逻辑中调用，你也可以把connect逻辑放到Express启动的异步流程里，和端口监听逻辑串行执行。

额外排查项（修改代码后仍连接失败可逐一核对） #

• 确认Docker Redis端口映射配置：执行docker ps查看容器端口列，确认映射规则为0.0.0.0:6379->6379/tcp，如果仅绑定了特定IP需要对应调整连接地址
• 确认Redis实例配置：如果容器内Redis开启了保护模式（默认开启）且未设置访问密码，会拒绝非回环地址的连接，你可以在启动容器时追加--protected-mode no参数临时关闭保护模式调试
• 如果你当前的Express服务也运行在Docker容器内，不能用localhost访问宿主机的Redis实例，需要替换为宿主机的局域网IP，或者将两个容器加入同一个Docker网络后用容器名作为地址访问

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