Redis容器拒绝连接本地端口6379？求解决方法

核心问题：容器间网络通信错误 #

你的NestJS应用容器试图连接127.0.0.1:6379，但该地址指向应用容器自身的localhost，而非Redis容器。在Docker Compose中，容器之间需通过服务名称作为主机名进行通信。

步骤1：修正Redis连接配置 #

将NestJS应用中Redis连接的主机地址从127.0.0.1或localhost改为redis（对应docker-compose.yaml中Redis服务的名称）。

示例配置（基于@nestjs/redis模块） #

import { RedisModule } from '@nestjs/redis';

@Module({
  imports: [
    RedisModule.forRoot({
      host: 'redis', // 替换为Docker Compose中的Redis服务名称
      port: 6379,
    }),
  ],
})
export class AppModule {}

环境变量方式（推荐） #

确保.env文件中Redis主机配置正确：

REDIS_HOST=redis
REDIS_PORT=6379

在NestJS中读取环境变量完成配置：

RedisModule.forRoot({
  host: process.env.REDIS_HOST,
  port: parseInt(process.env.REDIS_PORT, 10),
}),

步骤2：添加Redis健康检查（可选但关键） #

depends_on仅保证容器启动顺序，不确保Redis服务已就绪。添加健康检查让NestJS等待Redis完全启动后再运行：

修改docker-compose.yaml中的Redis服务：

redis:
  image: redis
  ports:
    - 6379:6379
  volumes:
    - redis:/data
  healthcheck:
    test: ["CMD", "redis-cli", "ping"]
    interval: 5s
    timeout: 3s
    retries: 5

更新api服务的depends_on规则：

api:
  # ...其他配置
  depends_on:
    redis:
      condition: service_healthy
    postgres:
      condition: service_started # Postgres也可参照Redis添加健康检查

步骤3：验证配置并重启容器 #

1. 停止当前运行的容器：

docker-compose down

2. 重新启动容器：

docker-compose -f docker-compose.yaml up

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