NodeJS将Docker Redis主机名转为localhost致连接失败求助

可能的原因及解决方法： #

• 环境变量未正确加载

  • 确保Node.js代码中已加载.env文件：在TS文件顶部加入import 'dotenv/config'（CommonJS环境用require('dotenv').config()），否则process.env.REDIS_HOST会是undefined，客户端会默认使用localhost。
  • 检查docker-compose.yml是否将.env传递给应用容器，添加env_file: .env配置，或者手动指定环境变量：

    services:
      eventsystem:
        # ...其他配置
        env_file: .env
    

  • 临时在代码中添加日志输出：console.log('REDIS_HOST:', process.env.REDIS_HOST)，启动容器后查看日志，确认环境变量是否正确获取。

• Redis客户端配置错误

  • 确认客户端初始化时正确传入了REDIS_HOST参数，以ioredis为例：

    import Redis from 'ioredis';
    const redisClient = new Redis({
      host: process.env.REDIS_HOST,
      port: 6379
    });
    

    若使用官方redis包：

    import { createClient } from 'redis';
    const redisClient = createClient({
      url: `redis://${process.env.REDIS_HOST}:6379`
    });
    

    任何情况下都不要遗漏host参数，否则客户端会自动 fallback 到localhost。

• Docker网络配置问题

  • 确保两个容器处于同一自定义网络中，在docker-compose.yml中定义并关联：

    version: '3.8'
    networks:
      app-net:
        driver: bridge
    services:
      eventsystem:
        # ...其他配置
        networks:
          - app-net
      redis-eventsystem:
        image: redis:alpine
        networks:
          - app-net
    

    自定义网络下容器名可直接作为主机名访问，避免默认bridge网络的潜在解析问题。

• 容器启动顺序问题

  • 虽然这不会导致主机名变为localhost，但可能引发连接失败。可通过健康检查确保Redis就绪后再启动应用：

    services:
      eventsystem:
        depends_on:
          redis-eventsystem:
            condition: service_healthy
      redis-eventsystem:
        image: redis:alpine
        healthcheck:
          test: ["CMD", "redis-cli", "ping"]
          interval: 5s
          timeout: 3s
          retries: 5
    

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