Docker Compose下Node.js连接Redis报ECONNREFUSED问题求助

可能的原因 #

• 代码硬编码或配置未加载：Node.js代码里可能直接写死了127.0.0.1，或者修改后的配置文件没同步到容器内（比如本地改了配置但没重新构建镜像、挂载的卷路径错误）。
• Redis客户端配置参数错误：使用的Redis客户端（如redis@4.x、ioredis）参数名写错，比如把host写成hostname，或者配置结构不符合客户端要求，导致客户端忽略自定义配置， fallback到默认的127.0.0.1。
• 构建产物缓存：如果是TypeScript等需要编译的项目，修改配置后没重新编译，容器运行的还是旧的编译产物，配置未更新。
• 环境变量覆盖：代码同时读取环境变量和配置文件时，环境变量中可能设置了REDIS_HOST=127.0.0.1，覆盖了配置文件的设置。

解决方案 #

1. 检查代码中的Redis连接逻辑 #

直接搜索代码里的127.0.0.1或localhost，确认是否存在硬编码：

// 错误示例：硬编码地址
const redis = require('redis').createClient({ host: '127.0.0.1', port: 6379 });

确保从配置文件或环境变量读取地址：

// 正确示例：从配置文件读取
const config = require('./config');
const redis = require('redis').createClient({ host: config.redis.host, port: config.redis.port });

2. 匹配Redis客户端的配置格式 #

不同客户端的配置参数有差异，需对应调整：

• redis@4.x版本推荐用url或socket对象配置：

  // 方式1：通过URL配置
  const redis = require('redis').createClient({ url: 'redis://redis1:6379' });
  // 方式2：通过socket对象配置
  const redis = require('redis').createClient({
    socket: { host: 'redis1', port: 6379 }
  });
  

• ioredis直接用host和port参数：

  const Redis = require('ioredis');
  const redis = new Redis({ host: 'redis1', port: 6379 });
  

3. 确保配置同步到容器 #

• 如果是挂载本地配置卷，检查Docker Compose的volumes配置是否正确：

  services:
    node-app:
      volumes:
        - ./config:/app/config # 本地配置目录需正确映射到容器内路径
  

• 如果配置打包进镜像，修改后需重新构建：

  docker-compose build node-app
  docker-compose up -d
  

4. 排查环境变量 #

查看容器内的环境变量，确认是否有覆盖Redis配置的项：

docker exec <node容器名> env | grep REDIS

如果存在REDIS_HOST=127.0.0.1这类变量，要么删除该环境变量，要么在代码中调整优先级（优先使用配置文件）。

5. 验证容器内的配置文件 #

进入Node.js容器，直接查看配置文件内容是否正确：

docker exec -it <node容器名> cat /app/config/redis.js

确认文件中的host确实是redis1或你设置的静态IP。

内容的提问来源于stack exchange，提问作者adib-enc