Docker持续使用缓存资源导致Next.js项目构建失败求助

核心错误原因 #

你的Dockerfile存在两个致命问题：

1. COPY命令源路径错误：COPY /app/.next/static /app/.next/static这类命令的源路径是本地构建上下文的绝对路径，而非容器内部路径。Docker的COPY只能从执行docker build的本地目录（构建上下文）复制文件到容器，无法读取容器内已生成的文件作为源。
2. 构建逻辑冗余混乱：你先把本地文件复制到容器内执行构建生成.next文件夹，之后又试图“复制容器内的文件到容器内”，这完全无意义，且直接触发路径找不到的错误。

同时，缓存异常问题也和Dockerfile步骤顺序有关——不合理的步骤导致即使加--no-cache，Docker仍错误复用缓存。

修正后的Dockerfile方案 #

方案1：多阶段构建（推荐，镜像体积更小） #

在构建阶段生成产物，再复制到运行阶段：

# 构建阶段
FROM node:22-alpine AS builder

ENV NEXT_TELEMETRY_DISABLED 1
ENV APP_ENV production
ENV NODE_ENV production

WORKDIR /app
COPY . .

RUN npm ci --omit=dev
RUN npm run build

# 运行阶段
FROM node:22-alpine

ENV NODE_ENV production
WORKDIR /app

# 从构建阶段复制产物到运行容器
COPY --from=builder /app/.next/standalone ./
COPY --from=builder /app/public ./public
COPY --from=builder /app/.next/static ./.next/static

CMD ["node", "/app/server.js"]

方案2：简化单阶段构建 #

直接使用容器内构建好的产物，无需额外COPY操作：

FROM node:22-alpine

ENV NEXT_TELEMETRY_DISABLED 1
ENV APP_ENV production
ENV NODE_ENV production

WORKDIR /app
COPY . .

RUN npm ci --omit=dev
RUN npm run build

# 直接使用容器内已生成的独立运行产物
CMD ["node", "/app/.next/standalone/server.js"]

彻底清理缓存的命令 #

如果仍存在缓存异常，执行以下命令彻底清理Docker相关缓存：

# 清理所有未使用的镜像、容器、卷和网络
docker system prune -af
# 清理构建缓存
docker builder prune -af

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