NextJS React项目本地启动异常：编译/_not-found且返回404错误

1. 确认首页路由文件存在 #

• App Router（Next 13+）项目：必须存在app/page.js（或.tsx/.jsx）文件，检查该文件是否被误删、改名或移动到子目录。
• Pages Router项目：必须存在pages/index.js（或对应后缀）文件，确认文件位置正确。

2. 彻底清理缓存与构建文件 #

执行以下命令清除残留缓存后重启服务：

# 删除Next构建目录
rm -rf .next
# 清除npm缓存
npm cache clean --force
# 重启开发服务器
npm run dev

3. 检查路由相关配置 #

• 打开next.config.js，确认没有配置rewrites、redirects或trailingSlash规则导致首页被拦截或重定向。
• 若项目同时存在app和pages目录，Next会优先使用App Router，此时需确保app/page.js存在，或在配置中明确指定路由模式。

4. 验证依赖版本与一致性 #

• 执行npm list next确认当前NextJS版本为14.2.16，若版本异常，重新安装依赖：

rm -rf node_modules package-lock.json
npm install

5. 检查文件名与权限 #

• 区分大小写的系统（macOS/Linux）下，确保首页文件名是全小写的page.js/index.js（如Page.js会被Next识别为不同文件）。
• 确认文件未被设置为隐藏，且当前用户有读取该文件的权限。

6. 排查文件系统异常 #

若以上步骤无效，尝试将项目复制到新目录后重新启动，排除原目录文件系统损坏的可能。

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