Docker环境下Nest容器无法连接PostgreSQL服务器求助

核心问题分析 #

从本地能正常访问数据库容器，但Nest容器连不上，主要是网络隔离和数据库初始化两个问题导致，以下是具体修复步骤：

1. 修复Docker网络关联 #

你在docker-compose.yml中定义了nestjs-crud网络，但两个服务都没有明确加入这个网络。Docker默认会为未指定网络的服务创建默认网络，但显式定义的网络未关联时，两个容器不在同一网络段，导致postgres域名无法解析。

修改后的docker-compose.yml：

version: '3.8'
services:
  nest-api:
    container_name: nest-api
    build:
      context: .
      dockerfile: Dockerfile
    ports:
      - 3333:3333
    networks:
      - nestjs-crud

  postgres:
    image: postgres:13.5
    container_name: postgres
    restart: always
    environment:
      - POSTGRES_USER=admin
      - POSTGRES_PASSWORD=admin
      - POSTGRES_DB=mydb
    volumes:
      - postgres:/var/lib/postgresql/data
    ports:
      - '5432:5432'
    networks:
      - nestjs-crud

volumes:
  postgres:

networks:
  nestjs-crud:

2. 自动创建目标数据库 #

你的DATABASE_URL指定了mydb，但PostgreSQL容器默认只会创建postgres数据库，不会自动生成自定义库。即使网络通了，也会因数据库不存在导致连接失败。

解决：在postgres服务的environment中添加POSTGRES_DB=mydb，如上配置所示，容器启动时会自动创建该数据库。

3. 验证.env文件是否被正确复制到容器 #

如果你的.dockerignore或.gitignore排除了.env文件，COPY . .不会将其复制到容器中，导致Nest应用读取不到正确的数据库地址。

检查与修复：

• 打开.dockerignore，确认没有包含.env
• 若有需求，可在Dockerfile中显式添加COPY .env .确保文件被复制

4. 优化容器启动顺序（可选） #

Nest容器启动速度可能快于PostgreSQL初始化完成的速度，导致启动时连接失败。可以通过健康检查确保Postgres就绪后再启动Nest：

添加健康检查的docker-compose.yml片段：

services:
  nest-api:
    # ... 其他配置
    depends_on:
      postgres:
        condition: service_healthy

  postgres:
    # ... 其他配置
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U admin -d mydb"]
      interval: 5s
      timeout: 5s
      retries: 5

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