Docker容器构建阶段能否发起网络请求？NextJS构建无法访问后端

我是Docker新手，正在将NextJS应用容器化。该应用需要调用同为容器化部署的Node/Express后端生成静态页面。后端可正常启动且能从容器外通过Postman访问，但前端容器执行npm run build（即next build命令）时，无法访问后端。

现有配置 #

docker-compose.yml #

version: '3.8'

services:
  backend:
    build:
      context: ./server
      network: app-network
    environment:
      - PORT=8000
      - NODE_ENV=production
    env_file:
      - ./server/.env
    ports:
      - "8000:8000"
    networks:
      - app-network

  frontend:
    build:
      context: ./client
      args:
        - SERVER_URL=http://backend:8000
    environment:
      - SERVER_URL=http://backend:8000
      - FRONTEND_URL=http://frontend:3000
      - NEXTAUTH_URL=http://localhost:3000
    env_file:
      - ./client/.env.local
    ports:
      - "3000:3000"
    networks:
      - app-network
    depends_on:
      - backend

networks:
  app-network:
    driver: bridge

前端Dockerfile #

FROM node:20-alpine3.19 

WORKDIR /app

ARG SERVER_URL
ENV SERVER_URL=$SERVER_URL

COPY package*.json ./
RUN npm install

RUN apk add --no-cache curl
RUN echo $SERVER_URL && curl --fail "$SERVER_URL/users/nextUserId" || (echo "Backend is not reachable" && exit 1)

COPY . .

RUN npm run build

后端Dockerfile #

FROM node:20-alpine3.19

WORKDIR /app

COPY ./package.json ./package-lock.json ./
RUN npm install
COPY . .

CMD ["npm", "run", "start"]

构建启动脚本 #

docker-compose up -d backend

until $(curl --output /dev/null --silent --fail http://localhost:8000/users/nextUserId); do
echo "Waiting for backend to be available..."
sleep 5 done

DOCKER_BUILDKIT=0 docker-compose build frontend

补充说明：我使用DOCKER_BUILDKIT=0是因为buildkit不支持在docker-compose.yml的build字段下指定network: app-network。

核心问题 #

前端镜像构建阶段（执行RUN命令时）的容器并未加入app-network网络，即使docker-compose.yml中配置了网络，也仅在容器运行时生效。你脚本中等待后端在宿主机可访问，但构建容器内部的curl无法通过http://backend:8000访问后端（不在同网络），也不能用localhost:8000（构建容器的localhost指向自身而非宿主机）。

具体修复步骤 #

1. 调整构建阶段的网络连接
   放弃在Dockerfile构建阶段执行curl检查，或者显式让构建容器加入app-network：

   • 移除前端Dockerfile中的curl检查步骤（构建阶段依赖运行中服务不符合容器化最佳实践）。
   • 若必须在构建阶段访问后端，修改构建命令，让构建容器加入指定网络：

     docker-compose up -d backend
     until $(curl --output /dev/null --silent --fail http://localhost:8000/users/nextUserId); do
       echo "Waiting for backend to be available..."
       sleep 5
     done
     # 用docker build替代docker-compose build，显式指定网络
     docker build --network app-network --build-arg SERVER_URL=http://backend:8000 -t frontend-image ./client
     docker-compose up -d frontend
     

2. 清理无效配置
   build.network是Docker BuildKit专属配置，你已关闭BuildKit，此配置无意义，直接删除：

   backend:
     build:
       context: ./server
       # 删除此行：network: app-network
   

3. 优化Next.js构建逻辑
   确保next build时使用的SERVER_URL指向同网络内的后端服务。如果静态页面生成必须依赖后端，优先保证构建容器与后端在同一网络，而非依赖宿主机端口映射。

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