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文件存在。
- 若使用Pages Router:确认根目录下存在
- 清理构建缓存:删除项目根目录下的
.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
相关产品推荐
相关产品推荐

