Next.js构建报错Invariant: page wasn't built，求排查方向

• 定位auth解构的代码位置
  全局搜索项目中所有解构auth的代码（比如const { auth } = xxx），重点检查服务端组件、路由处理器、数据获取函数（getStaticProps/getServerSideProps）——这些代码会在构建阶段执行，而开发环境可能有mock数据兜底，构建时没有就会触发null解构错误。优先对应Vercel日志里报错的页面，定位到具体文件。

• 核对构建环境的数据源与变量

  • 检查本地.env文件中的auth相关变量（如API密钥、认证服务地址），是否在Vercel构建环境中完整配置？缺失变量会导致请求返回null。
  • 验证构建时的数据源：比如开发用本地数据库，构建时连接的生产库是否有对应数据？或者认证接口在构建阶段是否返回了null？

• 排查依赖兼容性问题

  • 执行npm list next或yarn list next确认实际安装的版本，同时检查auth相关依赖（如next-auth、@clerk/nextjs）是否有自动更新，部分包可能和Next.js 14.1.0存在兼容问题。
  • 尝试回退到之前能正常构建的Next.js版本（如14.0.x），验证是否是新版本本身的bug导致。

• 检查Vercel构建配置

  • 最近是否修改过Vercel的构建命令、环境变量或缓存设置？尝试勾选跳过构建缓存重新构建，缓存的旧依赖可能引发异常。
  • 确认Vercel的构建预设为Next.js，避免自定义构建命令导致逻辑错误。

• 完善服务端逻辑的容错处理

  • 所有解构auth的位置，先判断父对象是否存在，比如改成const auth = e?.auth，或者添加前置判断if (!e) throw new Error('Auth context is missing')，避免直接解构null。
  • 检查App Router中layout.tsx的AuthProvider等上下文组件，确认服务端渲染时是否正确初始化了上下文，避免传递null值。

• 本地模拟生产构建

  • 本地执行next build && next start复现问题，在解构前添加console.log(e)，查看构建阶段e的实际值。
  • 如果本地构建正常，对比本地与Vercel的Node版本（比如本地用Node 18，Vercel是否用了Node 20），确保环境一致。

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