修改docker-compose中redis服务名后Node.js应用无法解析如何解决

问题根因与修复方案 #

1. 核心原因：Redis Node.js 客户端版本配置不兼容 #

你当前使用的redis.createClient参数写法是 v3.x版本 的规范，如果你项目中安装的是v4.x及以上版本的redis依赖包，该配置不会生效，客户端会默认尝试连接本地127.0.0.1:6379，自然无法解析docker-compose中定义的redis服务名。

2. 修复步骤 #

方案一：适配v4.x版本redis客户端（推荐）

修改Node.js连接redis的代码如下：

const express = require('express');
const redis = require('redis');

const app = express();
// v4.x版本写法，直接指定redis连接url
const client = redis.createClient({
    url: 'redis://redis:6379'
});
// v4.x需要手动调用connect方法触发连接
client.connect().catch(console.error);
client.set('visits', 0);

app.get('/', (req, res) => {
  client.get('visits', (err, visits) => {
    res.send('Number of visits is ' + visits);
    client.set('visits', parseInt(visits) + 1);
  });
});

app.listen(8081, () => {
  console.log('Listening on port 8081');
});

方案二：降级redis依赖到v3.x版本

修改你项目的package.json中redis依赖版本为：

"redis": "^3.1.2"

补充：优化docker-compose配置，解决启动顺序问题

添加启动依赖和健康检查，避免node-app在redis服务未就绪时提前启动导致连接失败：

version: '3.8'
services: 
    redis:
        image: 'redis'
        healthcheck:
          test: ["CMD", "redis-cli", "ping"]
          interval: 2s
          timeout: 2s
          retries: 10
    node-app:
        build: .
        ports:
            - "4001:8081"
        depends_on:
          redis:
            condition: service_healthy

最终执行命令重启服务

清理旧容器资源后重新构建启动：

docker-compose down -v
docker-compose up --build

内容的提问来源于stack exchange，提问作者Phone Min Khant