You need to enable JavaScript to run this app. 执行docker-compose up -d时多阶段构建Dockerfile报builder拉取权限错误
优惠活动
大模型
产品
解决方案
定价
更多

执行docker-compose up -d时多阶段构建Dockerfile报builder拉取权限错误

报错核心原因

你编写的Dockerfile不符合Docker构建语法规则:

  • COPY --from=builder是多阶段构建的专属语法,要求builder必须是通过独立FROM指令划分的独立构建阶段,才能被正常识别为本地构建生成的阶段产物
  • 你的Dockerfile仅定义了一个名为builder的阶段(仅存在一行FROM mhart/alpine-node:11 AS builder),在这个唯一阶段的内部执行跨阶段拷贝命令时,Docker会自动将builder识别为需要从公共镜像仓库拉取的外部镜像名称,最终触发“pull access denied for builder”的拉取权限报错
  • 这个报错的本质和同类场景逻辑一致:--from指向的资源没有被作为独立构建阶段正式定义,和是否存在多个阶段的表面形式无关,核心是语法不匹配。
可直接落地的解决方法

根据你的项目需求,有两种适配方向:

方案1:简化为单阶段构建(无额外多阶段逻辑)

如果不需要刻意压缩镜像体积,直接删掉Dockerfile中冗余的跨阶段拷贝行,把所有操作整合到同一个构建阶段中,修正后的Dockerfile内容如下:

FROM mhart/alpine-node:11
WORKDIR /app
COPY . .
# 一次性完成依赖安装、项目构建、静态服务安装
RUN yarn install \
  && yarn build \
  && yarn global add serve
CMD ["serve", "-p", "80", "-s", "."]

修改完成后直接执行docker-compose up -d即可正常启动,完全不存在跨阶段引用的语法问题。

方案2:规范使用多阶段构建(优化镜像体积)

如果希望通过多阶段构建剥离构建依赖、减小最终镜像大小,必须补上独立的运行时阶段,不能在单个构建阶段内部套用跨阶段拷贝语法,修正后的Dockerfile内容如下:

# 第一阶段:项目构建,产出静态dist文件
FROM mhart/alpine-node:11 AS builder
WORKDIR /app
COPY . .
RUN yarn install && yarn build

# 第二阶段:独立运行时阶段,和builder阶段的文件系统完全隔离
FROM mhart/alpine-node:11
WORKDIR /app
# 从独立定义的builder阶段拷贝构建产物
COPY --from=builder /app/build .
# 在运行时阶段单独安装启动所需的serve依赖
RUN yarn global add serve
CMD ["serve", "-p", "80", "-s", "."]

注意事项:多阶段的不同构建阶段文件系统完全独立,不能直接复用前一个阶段的依赖、工作目录,必须在运行时阶段单独配置运行必需的组件,否则会触发“serve command not found”类的新报错。

构建前的排查步骤
  • 清理旧的构建缓存:如果之前的错误构建残留了缓存逻辑,可先执行docker-compose build --no-cache清除所有本地构建缓存,再重新执行启动命令
  • 检查Docker版本:低于17.05的旧版Docker本身不支持多阶段构建语法,建议升级到稳定版的Docker和Docker Compose版本,避免语法解析兼容问题

内容的提问来源于stack exchange,提问作者Hamza Ince

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.25 00:24:02