You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

为何我的Next.js 13应用重启后出现404页面未找到错误?

解决Next.js 13重启后出现404页面的问题

针对你遇到的首次启动应用正常、关闭重开后出现404的问题,按以下步骤排查:

1. 核对路由文件规则

Next.js 13的App Router对路由文件的命名和位置有严格要求:

  • 首页必须放在 app/ 目录下(若使用src目录结构则为 src/app/)
  • 文件名必须是小写的 page.tsx,不能使用大写开头或其他变体名称
    对照你的文件夹结构截图确认是否符合该规则。

2. 清理开发缓存

缓存残留是这类问题的常见诱因,执行以下操作:

  • 停止当前开发服务(按 Ctrl+C)
  • 删除项目根目录下的 .next 文件夹
  • 清空npm缓存:
    npm cache clean --force
    
  • 重新启动开发服务:
    npm run dev
    

3. 检查服务启动日志

查看终端的服务启动日志,确认是否有加载 app/page.tsx 的相关提示。如果日志中未识别到该路由文件,说明文件位置或命名不符合规则。

4. 确认访问路径

确保你访问的是 http://localhost:3000,App Router中 app/page.tsx 对应根路径 /,不要额外添加子路径。

5. 排查配置文件异常

如果你的 next.config.js 中有 basePath、rewrites 等自定义路由配置,暂时注释掉这些配置,重启服务测试是否恢复正常。


内容的提问来源于stack exchange,提问作者Mehul Parekh

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.09 15:00:10