Next.js生产构建启动后访问根路径报404路由不存在错误

从你贴的构建日志看，根路由/已经被正确静态生成，构建流程本身没有问题。访问时返回JSON格式的404而不是Next.js默认的HTML 404页面，说明服务启动后没有正确加载路由表，或者你访问的根本不是当前启动的Next服务，按出现概率从高到低排查即可：

• 执行启动命令的工作目录错误
  next start不会自动追溯项目位置，只会读取当前执行命令目录下的.next构建产物。只要你执行npm run start时的工作目录和执行npm run build时的项目根目录不一致（比如在上级目录带--prefix参数启动、Docker运行阶段WORKDIR配置错误、手动挪动过.next文件夹位置），就会出现启动日志正常、但所有路由返回JSON 404的现象。
  修复：启动前先切到你执行build命令的项目根目录，确认当前目录下能直接看到.next文件夹和package.json，再执行启动命令。可以执行ls .next/server/pages/index.html（Pages Router项目）验证路由文件是否存在，能查到文件说明目录正确。

• 3000端口被其他服务占用
  你收到的{"message":"Route GET:/ not found"...}格式响应不是Next.js的默认返回，是轻量Node服务、反向代理的通用404格式。如果3000端口之前被其他后台服务占用，即使next start打印监听成功，实际流量会被已经占用端口的服务接收。
  修复：启动前先清理端口占用：Linux/macOS执行lsof -ti:3000 | xargs kill -9，Windows执行netstat -ano | findstr :3000找到对应PID后执行taskkill /F /PID 查到的PID，杀掉所有占用3000端口的进程后再重启服务。

• standalone输出配置与部署方式不匹配
  如果你在next.config.js里加了output: 'standalone'配置，构建后独立运行的服务产物会生成在.next/standalone目录下，此时在项目根目录直接执行next start会出现路由加载异常。
  修复：二选一即可：

  • 不需要精简独立部署的话，直接删除next.config.js里的output: 'standalone'配置，重新执行build后启动
  • 需要standalone部署的话，构建完成后将.next/standalone作为运行根目录，同时把.next/static、public文件夹分别复制到.next/standalone/.next/、.next/standalone/路径下，在standalone目录执行node server.js启动。

• Docker环境下的文件权限问题
  如果是容器内运行，构建阶段生成的.next目录默认是root权限，如果运行阶段用非root用户启动服务，会出现服务能启动但没有权限读取路由文件的问题。
  修复：在Dockerfile的build阶段结束后，加一行RUN chown -R 你的运行用户:用户组 .next，保证运行用户对.next目录有读取权限。

对照验证：你在本地非Docker环境，找一个空文件夹全程不切换目录，按你贴的create-next-app、build、start流程走一遍，默认配置下肯定能正常访问，和这个正常流程对比找环境差异即可快速定位问题。

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