docker-compose中为服务使用带不同参数的基础镜像问题

问题根源 #

你遇到的报错核心原因是：depends_on仅控制容器启动顺序，不影响镜像构建顺序。当Docker Compose构建frontend/backend服务时，本地还未生成frontend_base_image/backend_base_image，Docker会默认去Docker Hub拉取不存在的公共镜像，从而触发报错。此外，单独定义frontend_base/backend_base服务属于冗余操作——这些服务不需要运行，仅用于构建镜像，反而增加了复杂度。

解决方案一：复用基础Dockerfile，通过ARG传递差异参数（推荐） #

直接在基础Dockerfile中加入差异参数的ARG，动态生成符合前端/后端需求的镜像，无需单独维护基础服务。

1. 修改base.dockerfile，添加差异参数并动态配置：

FROM node:18

# 基础可复用参数
ARG WORKDIR
ARG TOOLSDIR
ARG LOCALDIR
# 前端/后端差异参数
ARG EXPOSE_PORT
ARG CMD_ARGS

ENV WORKDIR=${WORKDIR}

# 安装dumb-init初始化工具
RUN wget -O /usr/local/bin/dumb-init https://github.com/Yelp/dumb-init/releases/download/v1.2.5/dumb-init_1.2.5_x86_64
RUN chmod +x /usr/local/bin/dumb-init

WORKDIR ${WORKDIR}
RUN mkdir -p ${WORKDIR}

# 优先复制package.json利用Docker缓存
COPY ${LOCALDIR}/package*.json ${WORKDIR}
RUN npm install

COPY ${TOOLSDIR}/start.sh /usr/local/bin/start.sh
COPY ${LOCALDIR}/ ${WORKDIR}

# 动态设置端口和启动命令
EXPOSE ${EXPOSE_PORT}
ENTRYPOINT ["dumb-init"]
CMD ${CMD_ARGS}

2. 修改docker-compose.yml，删除冗余的base服务，直接为前端/后端传递对应ARG：

services:
  frontend:
    build:
      context: ./
      dockerfile: base.dockerfile
      args:
        - WORKDIR=/app/frontend/
        - TOOLSDIR=./docker/tools
        - LOCALDIR=./app/frontend/client
        - EXPOSE_PORT=3000
        - CMD_ARGS=["npm", "start"]
    # 前端服务额外配置（示例）
    ports:
      - "3000:3000"

  backend:
    build:
      context: ./
      dockerfile: base.dockerfile
      args:
        - WORKDIR=/app/backend/
        - TOOLSDIR=./docker/tools
        - LOCALDIR=./app/backend/api
        - EXPOSE_PORT=8080
        - CMD_ARGS=["npm", "run", "start:backend"]
    # 后端服务额外配置（示例）
    ports:
      - "8080:8080"

  postgresql:
    image: postgres:15-alpine
    # 数据库配置（示例）
    environment:
      - POSTGRES_USER=admin
      - POSTGRES_PASSWORD=password
      - POSTGRES_DB=mydb
    volumes:
      - postgres_data:/var/lib/postgresql/data/

volumes:
  postgres_data:

解决方案二：先构建基础镜像，再在服务Dockerfile中引用 #

如果坚持要分离基础镜像与服务镜像，需手动控制构建顺序：

1. 修改docker-compose.yml，标记base服务为非运行状态：

services:
  frontend_base:
    image: frontend_base_image
    build:
      context: ./
      dockerfile: base.dockerfile
      args:
        - WORKDIR=/app/frontend/
        - TOOLSDIR=./docker/tools
        - LOCALDIR=./app/frontend/client
    # 标记为无需运行的服务
    command: tail -f /dev/null
    deploy:
      replicas: 0

  backend_base:
    image: backend_base_image
    build:
      context: ./
      dockerfile: base.dockerfile
      args:
        - WORKDIR=/app/backend/
        - TOOLSDIR=./docker/tools
        - LOCALDIR=./app/backend/api
    command: tail -f /dev/null
    deploy:
      replicas: 0

  frontend:
    build: ./frontend
    depends_on:
      - frontend_base
    # 前端服务配置

  backend:
    build: ./backend
    depends_on:
      - backend_base
    # 后端服务配置

  postgresql:
    image: postgres:15-alpine
    # 数据库配置

2. 编写前端frontend/Dockerfile：

FROM frontend_base_image
EXPOSE 3000
ENTRYPOINT ["dumb-init"]
CMD ["npm", "start"]

3. 编写后端backend/Dockerfile：

FROM backend_base_image
EXPOSE 8080
ENTRYPOINT ["dumb-init"]
CMD ["npm", "run", "start:backend"]

4. 按顺序执行构建命令：

# 先构建基础镜像
docker-compose build frontend_base backend_base
# 再构建并启动所有服务
docker-compose up --build

注意事项 #

• 替换${PWD}为相对路径（如./docker/tools），避免跨平台路径解析问题，Docker会基于build.context自动解析相对路径。
• 安装dumb-init时，可提前下载文件到本地用COPY指令替代wget，减少网络依赖并提升安全性。

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