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

Next.js新项目启动后访问出现Page not found问题求助

解决全新Next.js项目启动后页面找不到的问题

问题详情

全新创建的Next.js项目,未修改任何代码,执行npm run dev后控制台提示:

ready started server on [::]:3000, url: http://localhost:3000

但访问该地址时出现Page not found错误,截图如下:
页面找不到错误截图

已尝试删除node_modules、重启电脑、检查端口占用,均未解决。

排查&解决步骤

  • 核对项目核心文件:
    • 若使用Pages Router:确认根目录下存在pages文件夹,且pages/index.js文件存在且内容完整(默认会有Next.js的欢迎页面代码)。
    • 若使用App Router:确认根目录下存在app文件夹,且app/page.js文件存在。
  • 清理构建缓存:删除项目根目录下的.next文件夹,然后重新执行npm run dev。
  • 验证Node.js版本:Next.js 13及以上版本要求Node.js 16.8+,执行node -v查看版本,不符合则升级Node.js到对应版本。
  • 更换访问地址:尝试访问http://127.0.0.1:3000,避免localhost解析异常问题。
  • 重新创建项目:用官方命令重新初始化项目,排除创建过程中的异常:
    npx create-next-app@latest my-test-app
    cd my-test-app
    npm run dev
    
    完成后测试能否正常访问页面。

内容的提问来源于stack exchange,提问作者Raju Sharma Dahal

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.07.12 15:45:56