构建含PostgreSQL的Docker镜像失败，求助排查数据库连接问题

docker build是在独立的构建容器中执行的，这个容器内部没有启动PostgreSQL服务，而你的代码在构建阶段（pnpm build）尝试连接127.0.0.1:5432，指向的是构建容器自身，自然会出现连接被拒绝的错误。另外，即使宿主机或其他容器运行了PostgreSQL，构建阶段默认也无法直接访问。

1. 拆分构建与运行时的数据库操作 #

构建阶段不应该依赖真实数据库连接。检查你的pnpm build脚本，看是否包含了数据库迁移、模型生成这类需要连接数据库的操作：

• 如果是迁移命令：把迁移步骤移到容器启动阶段（比如写个entrypoint脚本，启动应用前先执行迁移）。
• 如果是代码逻辑在构建时主动连接数据库：修改代码，让数据库初始化逻辑只在应用运行时触发，构建过程跳过连接操作。

2. 调整Dockerfile，隔离构建依赖 #

修改Dockerfile，确保构建过程不涉及数据库连接：

FROM node:20-alpine

WORKDIR /app

# 先复制依赖文件，利用Docker缓存
COPY package.json pnpm-lock.yaml ./
RUN npm install -g pnpm && pnpm install --frozen-lockfile

# 复制源码
COPY . .

# 执行构建（确保此时无需连接数据库）
RUN pnpm build

# 启动命令，可在这里加入迁移步骤
CMD ["sh", "-c", "pnpm migrate && pnpm start"]

3. 配置docker-compose的数据库网络 #

容器运行时，通过docker-compose的服务名作为数据库地址（而不是127.0.0.1），配置示例：

version: '3.8'
services:
  app:
    build: .
    image: pulsodenieve-vps:latest
    depends_on:
      - db
    environment:
      # 用服务名"db"作为数据库主机，Docker会自动解析到对应容器
      - DB_HOST=db
      - DB_PORT=5432
      - DB_USER=your_db_user
      - DB_PASSWORD=your_db_pwd
      - DB_NAME=your_db_name
    ports:
      - "3000:3000"

  db:
    image: postgres:15-alpine
    environment:
      - POSTGRES_USER=your_db_user
      - POSTGRES_PASSWORD=your_db_pwd
      - POSTGRES_DB=your_db_name
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  postgres_data:

4. 修改数据库配置文件，使用环境变量 #

把硬编码的127.0.0.1改成读取环境变量，适配不同环境：

// dbConfig.ts
export const dbConfig = {
  host: process.env.DB_HOST || 'localhost',
  port: parseInt(process.env.DB_PORT || '5432', 10),
  username: process.env.DB_USER || 'postgres',
  password: process.env.DB_PASSWORD || 'postgres',
  database: process.env.DB_NAME || 'pulsodenieve',
};

5. 特殊情况：构建阶段必须连数据库（不推荐） #

如果确实需要在构建阶段访问数据库，可在构建时指定网络让容器能访问外部服务：

# 让构建容器使用宿主机网络，访问宿主机上的PostgreSQL
docker build --network host -t pulsodenieve-vps:latest .

这种做法会让构建过程依赖外部服务，不建议用于生产环境。

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