Next.js执行npm run build报错：Failed to collect page data for /dashboard

1. 拉取完整错误日志 #

默认构建日志可能隐藏关键报错，执行以下命令强制输出完整错误信息：

NEXT_PRINT_BUILD_ERRORS=true npm run build

也可以直接查看.next/build目录下的日志文件，定位和/dashboard页面相关的具体报错点。

2. 检查页面数据获取逻辑 #

Next.js页面的getStaticProps、getServerSideProps、generateStaticParams这几个数据获取函数如果抛出异常，会直接导致页面数据收集失败：

• 核对函数内的API请求是否正常（比如接口地址错误、权限失效、返回格式不匹配）
• 排查变量未定义、数组越界、类型转换错误等基础问题
• 若为动态路由页面，确认generateStaticParams返回的参数是否合法

3. 彻底清理缓存与依赖 #

即使重新克隆过仓库，也需要确保无缓存干扰：

• 删除.next文件夹和node_modules目录，重新执行npm install && npm run build
• 清理npm全局缓存：npm cache clean --force
• 核对package-lock.json或yarn.lock的依赖版本与仓库一致，避免版本差异引发问题

4. 验证环境变量配置 #

构建时缺失必要环境变量会导致数据获取失败：

• 确认.env.production文件存在，且内部变量（如API地址、密钥）配置正确
• 注意Next.js规则：仅前缀为NEXT_PUBLIC_的变量会暴露给客户端，服务端数据获取函数可使用所有环境变量

5. 测试开发模式状态 #

执行npm run dev，访问/dashboard页面：

• 若开发模式也报错，直接查看浏览器控制台的错误信息即可定位问题
• 若开发模式正常，说明问题出在构建阶段的特殊逻辑（如静态生成时的预取数据逻辑）

6. 核对依赖与Node版本兼容性 #

• 查看package.json的engines字段，确认Node.js 16是否符合项目版本要求
• 检查Next.js版本，部分版本对Node.js 16的子版本存在兼容问题，可尝试升级或降级到对应稳定版（如13.x系列稳定版）

7. 排查第三方组件/库问题 #

如果/dashboard页面使用了第三方工具或UI库，可能是这类库在构建时抛出异常：

• 临时注释页面内的第三方组件，逐步排查哪个组件引发问题
• 检查第三方库版本，尝试更新到最新稳定版修复已知构建bug

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