构建Next.js独立生产环境后访问_next/文件出现404错误

问题原因 #

启用output: 'standalone'后，Next.js会生成精简的独立服务端文件，但默认不会自动包含SSG/ISR生成的_next/data目录文件，部分静态清单文件的路径映射也可能出现偏差，导致生产环境下这些资源无法被服务端正确识别。

解决方案 #

1. 修正Dockerfile的文件复制逻辑 #

修改Dockerfile的runner阶段，补充复制SSG/ISR数据文件及关键清单文件：

# Production image, copy all the files and run next
FROM base AS runner
WORKDIR /app

ENV NODE_ENV production
# Uncomment the following line in case you want to disable telemetry during runtime.
# ENV NEXT_TELEMETRY_DISABLED 1

RUN addgroup --system --gid 1001 nodejs
RUN adduser --system --uid 1001 nextjs

COPY --from=builder /app/public ./public

# 复制SSG/ISR数据文件和核心清单文件
COPY --from=builder --chown=nextjs:nodejs /app/.next/data ./.next/data
COPY --from=builder --chown=nextjs:nodejs /app/.next/prerender-manifest.json ./.next/prerender-manifest.json
COPY --from=builder --chown=nextjs:nodejs /app/.next/BUILD_ID ./.next/BUILD_ID

# 确保缓存目录权限正确
RUN mkdir -p .next/cache
RUN chown -R nextjs:nodejs .next

# 复制独立服务端程序和静态资源
COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./
COPY --from=builder --chown=nextjs:nodejs /app/.next/static ./.next/static

USER nextjs

EXPOSE 3000

ENV PORT 3000
ENV HOSTNAME "0.0.0.0"

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

2. 本地运行时的文件结构验证 #

执行npm run build后，检查项目根目录下的.next文件夹，确保data目录、prerender-manifest.json、BUILD_ID文件存在，并且在运行node server.js前，这些文件处于正确的路径下（即项目根目录的.next文件夹内）。

3. 升级Next.js版本 #

部分旧版本Next.js在standalone模式下存在静态资源路径bug，建议升级到最新稳定版（如13.x或14.x），规避已知的路径映射问题。

4. 确认i18n配置的文件生成 #

虽然你的i18n仅配置了en locale，但需确保SSG页面生成时，locale相关的数据文件被正确生成在_next/data/[BUILD_ID]/en/目录下，且该目录被完整复制。

验证方式 #

修改后重新构建Docker镜像并运行，或本地执行npm run build+node server.js，打开浏览器控制台检查是否仍有404错误；也可直接访问之前报错的URL（如http://localhost:3000/_next/data/[BUILD_ID]/en.json），确认是否能正常返回内容。

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