Next.js Docker构建失败：缺失.next/cache文件夹（生产环境异常）

问题详情 #

相同的Dockerfile与CodeBuild配置，在开发环境可正常构建镜像，但生产环境构建失败，报错如下：

Build error occurred
[Error: ENOENT: no such file or directory, stat '/app/.next/cache'] {
   errno: -2,
   code: 'ENOENT',
   syscall: 'stat',
   path: '/app/.next/cache'
 }
 npm ERR! code ELIFECYCLE

已确认执行npm run build时使用root用户，排除基础权限问题，对应的Dockerfile内容：

FROM public.ecr.aws/docker/library/node:14-alpine AS deps
WORKDIR /app
COPY package*.json yarn.lock ./
RUN yarn install --production=false --pure-lockfile --ignore-engines

FROM public.ecr.aws/docker/library/node:14-alpine AS builder
WORKDIR /app

RUN apk add --no-cache libc6-compat curl
COPY . .
COPY --from=deps /app/package.json .
COPY --from=deps /app/node_modules ./node_modules

RUN DEBUG=graphql:errors,graphql:queries,cache:redis DEBUG_COLORS=true npm run build --debug

RUN addgroup --system --gid 1001 app_user \
  && adduser --system --uid 1001 --shell /bin/bash -D app_user \
  && chown -R app_user:app_user /app \
  && echo "export PATH=$PATH:/usr/bin/curl" >> /etc/profile

USER app_user
HEALTHCHECK --interval=30s --timeout=5s --retries=3 CMD curl -f http://localhost:8080/blog || exit 1
EXPOSE 8080 6379
ENTRYPOINT [ "npm", "start"]

解决思路与方案 #

1. 预创建Next.js缓存目录 #

Next.js在构建过程中会尝试访问.next/cache目录，但如果该目录提前不存在，可能触发ENOENT错误。在Dockerfile的builder阶段，执行build命令前手动创建该目录：

修改builder阶段的指令，在RUN npm run build前添加：

RUN mkdir -p /app/.next/cache

2. 检查CodeBuild缓存策略 #

生产环境CodeBuild若启用了缓存，可能导致缓存中的旧数据干扰构建，比如缓存目录被错误清理或未同步。可以：

• 临时禁用CodeBuild缓存进行测试，确认是否是缓存导致的问题
• 调整缓存配置，将.next/cache排除在缓存范围外

3. 验证Next.js配置一致性 #

检查项目next.config.js中是否存在生产环境专属的缓存路径配置，确保配置的缓存目录为/app/.next/cache，避免自定义路径导致目录不存在。

4. 确认Docker构建上下文完整性 #

确保生产环境CodeBuild拉取的代码与开发环境完全一致，不存在脚本依赖未生成的.next目录的情况（虽然.next通常在.gitignore中，但自定义构建脚本可能存在依赖逻辑）。

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