Next.js应用将pages文件夹迁移到src目录后出现404错误如何解决

按以下步骤依次排查即可解决问题：

• 第一步：确认目录结构正确
  你需要将根目录下完整的pages文件夹直接移入src目录，不能嵌套多余层级，正确结构参考：

  项目根目录
  ├── src
  │   └── pages
  │       ├── index.js（对应首页路由/，原根目录pages下的所有文件直接移到此处）
  │       └── 其他页面文件/子路由文件夹
  ├── jsconfig.json
  ├── package.json
  └── next.config.js（可选）
  

• 第二步：重启开发服务
  修改目录结构后必须停掉当前正在运行的npm run dev（或yarn dev、pnpm dev）进程，重新执行启动命令，Next.js才会识别新的src/pages目录，未重启服务是新手出现该问题的最常见原因。
• 第三步：异常情况排查
  如果做完前两步仍有404，执行以下操作：
  1. 确认src/pages下存在对应路由的页面文件，比如访问根路径localhost:3000必须存在src/pages/index.js/tsx/jsx文件
  2. 删除项目根目录下的.next缓存文件夹后再重启开发服务
  3. 你目前写的jsconfig.json配置是正确的，该配置仅用于简化导入路径，和Next.js查找页面路由的逻辑无关，不需要修改。

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