Next.js项目执行docker-compose up构建app服务失败如何解决

这个报错和Docker仓库权限没有关系，本质是多阶段构建的阶段名引用错误：Docker找不到本地定义的构建阶段时，会默认把引用名当成远程公共镜像去Docker Hub拉取，自然会出现仓库不存在、拉取权限不足的报错。
你的Dockerfile里存在2处直接触发报错的错误：

• 第一个构建阶段的别名拼写错误：首行定义阶段时写的是As dependecies（正确拼写应为dependencies，漏写了字母n），但后续COPY --from=dependencies引用时使用了正确拼写，Docker无法匹配到本地阶段，就尝试拉取远程library/dependencies公共镜像。
• 存在无效的不存在阶段引用：COPY --from=build /app .这行中引用的build阶段从未在Dockerfile中定义，你实际定义的阶段只有拼写错误的dependecies、builder、runner三个，Docker同样会尝试拉取不存在的远程library/build公共镜像。

直接修改Dockerfile内容，修正两处错误：

1. 修正第一行的阶段名拼写错误
2. 删除多余的、引用不存在阶段的COPY --from=build /app .行，该行无实际作用，你后续已经从builder阶段拷贝了所有运行需要的文件。

修正后的完整Dockerfile内容如下：

# get NPM Packages
FROM node:16-alpine AS dependencies

RUN apk add --no-cache libc6-compat

WORKDIR /app

COPY package.json package-lock.json ./
RUN npm ci --only=production

# Rebuild the source code only when needed
FROM node:16-alpine AS builder
WORKDIR /app
COPY . .
COPY --from=dependencies /app/node_modules ./node_modules
RUN npm run build

# Production image, copy all the files and run next
FROM node:16-alpine AS runner
WORKDIR /app

ENV NODE_ENV production

RUN addgroup -g 1001 -S nodejs
RUN adduser -S nextjs -u 1001

COPY --from=builder --chown=nextjs:nodejs /app/.next ./.next
COPY --from=builder /app/node_modules ./node_modules
COPY --from=builder /app/package.json ./package.json

USER nextjs
EXPOSE 3000

CMD ["npm", "start"]

你当前Dockerfile的依赖安装逻辑存在潜在问题：dependencies阶段只安装了production生产依赖，把这些依赖拷贝到builder阶段后执行npm run build时，会缺失Next.js构建所需的devDependencies（比如next、typescript、eslint等包如果放在devDependencies里就会找不到），如果后续构建时报依赖缺失错误，调整依赖安装逻辑即可：在builder阶段安装全量依赖用于构建，最终runner阶段只保留生产依赖。

修改完成后先执行以下命令清除旧的错误构建缓存，重新构建镜像：
docker-compose build --no-cache
构建成功后再执行docker-compose up启动服务即可。

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