Docker Compose部署NestJS+PostgreSQL连接失败求助

针对你遇到的PostgreSQL拒绝连接、日志显示database system was shut down at <<某个时间戳>>的问题，以下是排查和解决步骤：

1. 确保容器启动顺序正确 #

PostgreSQL启动需要时间完成初始化，NestJS容器不能在数据库就绪前发起连接。在docker-compose.yml中添加依赖和健康检查：

version: '3.8'
services:
  postgres:
    image: postgres:15-alpine
    environment:
      POSTGRES_USER: your_user
      POSTGRES_PASSWORD: your_password
      POSTGRES_DB: your_db
    ports:
      - "5432:5432"
    volumes:
      - postgres_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U your_user -d your_db"]
      interval: 5s
      timeout: 5s
      retries: 5
  nestjs-app:
    build: .
    ports:
      - "3000:3000"
    depends_on:
      postgres:
        condition: service_healthy
    environment:
      DB_HOST: postgres  # 使用Docker Compose服务名，而非host.docker.internal
      DB_PORT: 5432
      DB_USER: your_user
      DB_PASSWORD: your_password
      DB_NAME: your_db
volumes:
  postgres_data:

• 说明：depends_on配合service_healthy确保NestJS仅在PostgreSQL完全就绪后启动；healthcheck通过pg_isready检测数据库是否可接受连接。

2. 修正TypeORM数据源配置 #

确保TypeORM配置中使用Docker Compose服务名作为数据库主机，而非localhost或host.docker.internal：

// src/data-source.ts
import { DataSource } from 'typeorm';

export const AppDataSource = new DataSource({
  type: 'postgres',
  host: process.env.DB_HOST || 'postgres',
  port: parseInt(process.env.DB_PORT) || 5432,
  username: process.env.DB_USER || 'your_user',
  password: process.env.DB_PASSWORD || 'your_password',
  database: process.env.DB_NAME || 'your_db',
  entities: [__dirname + '/**/*.entity{.ts,.js}'],
  synchronize: false,
  migrations: [__dirname + '/migrations/**/*{.ts,.js}'],
});

• 注意：同一Docker Compose网络内的服务可直接通过服务名互相访问，无需依赖宿主机端口映射。

3. 清理损坏的PostgreSQL数据卷 #

若之前的数据库数据卷因异常关机等原因损坏，会导致PostgreSQL无法正常提供服务：

1. 停止并删除所有容器及关联数据卷：

docker-compose down -v

2. 重新构建并启动容器：

docker-compose up --build

• 此操作会让PostgreSQL重新初始化干净的数据库环境。

4. 检查PostgreSQL容器完整日志 #

查看PostgreSQL启动日志，定位初始化错误：

docker-compose logs postgres

• 若日志出现FATAL: database "your_db" does not exist或FATAL: role "your_user" does not exist，需确保docker-compose.yml中的POSTGRES_*环境变量与NestJS配置完全一致；
• 若日志显示could not bind to address 0.0.0.0:5432: address already in use，说明宿主机5432端口被占用，可关闭宿主机本地PostgreSQL服务，或修改docker-compose.yml中PostgreSQL的端口映射为"5433:5432"。

5. 验证容器网络连通性 #

进入NestJS容器，测试与PostgreSQL容器的网络连通性：

docker-compose exec nestjs-app ping postgres

若ping不通，检查Docker Compose网络配置——默认情况下所有服务会加入同一默认网络，若自定义了网络，需确保两个服务都在该网络内。

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