docker-compose部署下Node.js容器无法连接Redis容器报错如何解决？

问题排查与解决方案 #

核心现象确认 #

首先从报错日志可以看出，当前Node服务实际发起连接的地址依然是127.0.0.1:6379，说明你修改的Redis连接地址未生效，优先排查以下原因： #

1. 代码修改未生效 #

你配置了本地代码到容器的bind挂载，若修改代码后没有重启容器内的Node进程，运行的依然是旧版本代码，会持续使用localhost作为连接地址。
验证方式：在Redis连接逻辑前加日志输出当前使用的host值：

console.log('当前Redis连接host：', process.env.REDIS_HOST || 'localhost')

启动容器后查看日志，如果输出为localhost即可确认代码未生效，重启Node服务即可。 #

2. 未给API容器注入REDIS_HOST环境变量 #

你当前的docker-compose配置中没有给api服务配置环境变量，即便代码读取process.env.REDIS_HOST，容器内不存在该变量，会自动fallback到默认值localhost。
解决方法：在api服务的docker-compose配置中添加环境变量配置：

api: 
  build: ./api
  ports: 
    - "3004:3004"
  volumes:
    - type: bind
      source: ./api
      target: /usr/src/api
  working_dir: /usr/src/api
  depends_on: 
    - redis
  networks:
    - backend
  # 新增环境变量配置
  environment:
    - REDIS_HOST=redis

3. Redis NPM包版本兼容问题 #

若你使用的是redis@4.x及以上版本的客户端，旧版本的传参格式已经失效，默认会连接localhost:6379。

v4+版本正确写法：

方式一：传入完整连接URL

const redisClient = require("redis").createClient({
  url: process.env.REDIS_HOST ? `redis://${process.env.REDIS_HOST}:6379` : 'redis://localhost:6379'
});
// v4版本需要显式调用connect方法发起连接
await redisClient.connect()

方式二：通过socket字段配置连接参数

const redisClient = require("redis").createClient({
  socket: {
    host: process.env.REDIS_HOST || 'localhost',
    port: 6379
  }
});
await redisClient.connect()

4. 服务启动时序问题 #

depends_on仅控制容器启动顺序，不保证Redis服务完全初始化就绪后再启动API服务，可能出现API启动时Redis还未完成启动导致连接失败。
解决方法：给Redis服务添加健康检查，配置API等待Redis健康后再启动：

redis: 
  image: "redis:latest"
  ports: 
    - "6379:6379"
  hostname: redis
  networks:
    - backend
  # 新增健康检查配置
  healthcheck:
    test: ["CMD", "redis-cli", "ping"]
    interval: 2s
    timeout: 2s
    retries: 10

api:
  # 其余配置不变
  depends_on: 
    redis:
      condition: service_healthy

5. 网络连通性验证 #

若以上方法都无效，可手动验证容器网络连通性：

1. 执行docker exec -it <你的api容器名称> sh进入API容器
2. 执行nc -zv redis 6379测试网络连通性
   • 若提示连接成功，说明是代码逻辑问题
   • 若提示连接失败，执行docker network inspect backend查看两个容器是否都加入了该网络，确认网络配置无误

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