Docker-Compose修改Redis端口后应用连接异常问题求助

兄弟，我帮你捋捋这个问题——改Redis端口后应用连不上但容器都正常，十有八九是配置同步没做好或者没搞懂Docker的网络逻辑，咱们一步步排查解决：

1. 先把.env和Docker-Compose的端口映射逻辑搞清楚 #

首先，你改了Redis端口后，得先确认这俩地方的配置是不是对应上了：

• 你的.env文件里肯定加了类似REDIS_PORT=6380（假设你改成了6380）
• 然后看Docker-Compose里Redis服务的ports配置，这里很容易踩坑：

  redis:
    image: redis:latest
    ports:
      - "${REDIS_PORT}:6379"  # 划重点！容器内部Redis默认监听6379，你改的是**宿主机对外的映射端口**，不是容器内的端口
    volumes:
      - redis_data:/data
  

  如果你是让Node.js应用和Redis在同一个Compose网络里（默认会自动创建专属网络），那应用连Redis应该用容器内的6379端口，而不是你改的宿主机端口！这是很多人栽跟头的地方。

2. 检查Node.js应用的Redis连接代码 #

这是最常见的问题——要么代码硬编码了端口，要么没正确读取.env的配置：

• 错误示例（硬写死端口，没同步修改）：

  const redisClient = redis.createClient({
    host: 'redis', // 这里用Compose服务名做域名是对的
    port: 6379 // 如果你改了宿主机端口但没搞懂内部网络，这里就会出问题？不对——如果是内部通信，这个6379是对的，除非你改了容器内的Redis端口
  });
  

  正确的姿势应该是根据环境区分配置：

  // 读取.env配置，内部通信用服务名+容器内端口，本地调试才用localhost+宿主机端口
  const redisConfig = {
    host: process.env.REDIS_HOST || 'redis',
    port: process.env.REDIS_INTERNAL_PORT || 6379 // 容器内端口，除非你特意改了Redis容器的启动端口
  };
  const redisClient = redis.createClient(redisConfig);
  

3. 如果你真的要改Redis容器内部的端口 #

如果你不满足于只改宿主机映射，非要改容器内Redis的监听端口，那得在Compose里加启动命令：

redis:
  image: redis:latest
  command: redis-server --port 6380 # 强制让Redis在容器内监听6380
  ports:
    - "${REDIS_PORT}:6380" # 宿主机端口映射到容器内的新端口
  volumes:
    - redis_data:/data

这种情况下，你的应用连接Redis的端口就得改成6380，同时host还是redis服务名。

4. 彻底重启容器，清掉旧缓存 #

有时候改了配置后，容器没完全重启，应用还在沿用旧的连接配置：

• 执行docker-compose down（如果Redis数据不重要，加-v删掉卷彻底清理），然后docker-compose up -d重新启动所有服务。
• 另外，Node.js应用如果用了pm2或者热重载没生效，也要确保它重新读取了新的.env文件。

5. 验证连通性，定位问题 #

可以进入Node.js容器内部，测试能不能连上Redis：

# 进入你的Node.js容器
docker exec -it <你的Node容器名称> sh
# 装个telnet（如果容器里没有的话）
apt-get update && apt-get install -y telnet
# 测试连接：telnet <Redis服务名> <容器内端口>
telnet redis 6379

如果能连通，说明网络没问题，问题肯定在应用代码的配置；如果连不通，去看Redis容器的日志，确认它监听的端口：

docker logs <你的Redis容器名称>
# 正常日志会显示类似 "Ready to accept connections on port 6379" 的内容，看看端口对不对

• 只是改宿主机访问Redis的端口：保持容器内Redis端口为6379，Compose里ports设为新端口:6379，应用连接用redis:6379（内部网络）或者localhost:新端口（本地调试）。
• 要改容器内Redis端口：在Compose里用command指定新端口，同时更新应用的连接端口为新的容器内端口，ports映射为新宿主机端口:新容器端口。
• 绝对不要在代码里硬编码端口，一定要读取.env的配置。
• 改完配置一定要彻底重启所有容器，别留旧缓存。

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