Docker部署Node.js后端连接Redis报ECONNREFUSED错误如何解决

报错明确显示后端正在尝试连接本地127.0.0.1的6379端口，说明代码中配置的process.env.REDIS_HOST没有生效，自动fallback到了默认值，按以下顺序排查即可：

• 首先验证环境变量是否正确传入容器：进入运行中的backend容器执行echo $REDIS_HOST，如果输出不是redis，说明docker-compose配置的环境变量没有生效
• 检查代码中环境变量加载时机：如果你项目使用了dotenv加载配置，确认dotenv初始化代码在Redis实例初始化代码之前执行，Node.js模块导入是同步执行的，如果Redis初始化的模块在dotenv配置加载前就被导入，就会读不到环境变量
• 排查env文件优先级冲突：docker-compose中environment字段优先级高于env_file，如果./docker/env/.env.dev中配置了REDIS_HOST，正常会被environment的配置覆盖，也可以直接删掉env文件中的Redis相关配置避免冲突
• 启动顺序问题验证：depends_on仅保证容器启动顺序，不保证Redis服务完全就绪，但该问题的报错会是连接redis:6379被拒绝，和当前报错不符，可以作为次要排查项

1. 调整环境变量加载顺序
   在项目入口文件最顶部优先加载环境变量，再导入其他业务模块：

// 入口文件第一行执行
require('dotenv').config();
// 后续再导入用到Redis的模块
import { pubsub } from './redis-pubsub';

2. 增加环境变量校验逻辑
   修改Redis配置代码，增加日志确认连接地址，避免静默使用默认值：

const REDIS_HOST = process.env.REDIS_HOST || "127.0.0.1";
const REDIS_PORT = process.env.REDIS_PORT || 6379;
// 开发环境打印连接信息方便排查
if (process.env.ENVIRONMENT === 'development') {
  console.log(`Redis connecting to ${REDIS_HOST}:${REDIS_PORT}`);
}

const redisPubSubOptions: any = {
  host: REDIS_HOST,
  port: REDIS_PORT,
  connectTimeout: 10000,
  retryStrategy: (times: any) => Math.min(times * 50, 2000),
};

export const pubsub: RedisPubSub = new RedisPubSub({
  publisher: new Redis(redisPubSubOptions),
  subscriber: new Redis(redisPubSubOptions),
});

3. 增加服务启动等待逻辑
   避免Redis未就绪导致的连接失败，修改docker-compose的backend启动命令：

backend:
  command: sh -c "npx wait-on tcp:redis:6379 && yarn run dev"

4. 可选优化：修正Dockerfile端口配置
   当前Dockerfile中EXPOSE 4000和实际服务监听的4242端口不一致，可修改为对应端口，避免后续端口映射出错。

内容的提问来源于stack exchange，提问作者robenson-dev