Docker构建阶段无法访问Postgres容器，该如何处理？

方案1：使用宿主网络构建 #

让构建阶段的容器共享宿主机器的网络栈，此时localhost会指向宿主，只要Postgres容器已将5432端口映射到宿主即可。

• 执行构建命令时添加--network host参数：

  docker build --network host -t your-app-image .
  

• 保持.env中的数据库地址不变：

  DATABASE_URL=postgresql://postgres:mypassword@localhost:5432/postgres
  

方案2：传递Postgres容器的IP地址 #

先获取运行中Postgres容器的IP，再通过构建参数传递给构建阶段。

1. 获取Postgres容器的IP：

   docker inspect -f '{{range.NetworkSettings.Networks}}{{.IPAddress}}{{end}}' your-postgres-container-name
   

2. 修改Dockerfile，添加构建参数支持：

   FROM node:16-alpine
   
   ARG DATABASE_URL
   ENV DATABASE_URL=$DATABASE_URL
   
   WORKDIR /site
   
   COPY package*.json .
   RUN npm ci
   
   COPY . .
   RUN npx prisma db pull
   RUN npx prisma generate
   RUN npm run build
   
   EXPOSE 3000
   CMD ["node", "-r", "dotenv/config", "build"]
   

3. 带参数执行构建：

   docker build --build-arg DATABASE_URL=postgresql://postgres:mypassword@<postgres-ip>:5432/postgres -t your-app-image .
   

方案3：使用Docker BuildKit连接现有网络（推荐） #

利用BuildKit特性，让构建阶段直接加入Postgres容器所在的Docker网络，通过容器名直接访问数据库。

1. 确保Postgres容器与自定义网络关联：

   # 未创建网络则先创建
   docker network create app-network
   # 将Postgres容器加入网络
   docker network connect app-network your-postgres-container-name
   

2. 修改.env中的主机名为Postgres容器的名称：

   DATABASE_URL=postgresql://postgres:mypassword@your-postgres-container-name:5432/postgres
   

3. 启用BuildKit并指定网络构建：

   DOCKER_BUILDKIT=1 docker build --network app-network -t your-app-image .
   

注意事项 #

• 构建过程中必须保证Postgres容器处于运行状态，且网络连通。
• 敏感信息（如数据库密码）避免硬编码，优先通过CI环境变量或构建参数传递，不要提交到代码仓库。
• CI环境中需先启动Postgres服务容器并加入同一网络，再执行构建步骤。

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