Next.js App Router项目首次构建失败，报错/_not-found配置收集失败

安全阿岳

2026-6-16

解决Next.js App Router构建时TypeError: c(...).createContext is not a function错误

检查React与Next.js版本兼容性
这个错误大概率是版本不匹配导致的，Next.js 13+ 要求 React 18.x 及以上版本。执行npm list react next查看当前版本，确保满足要求。如果版本不符，执行以下命令升级：
```
npm install react@latest react-dom@latest next@latest
```
清理依赖缓存后重新安装
依赖缓存损坏也可能引发这类问题，执行以下步骤重置依赖：
```
rm -rf node_modules package-lock.json yarn.lock
npm install
```
排查第三方库的React版本冲突
部分第三方包可能依赖旧版React，导致上下文创建API不兼容。用npm ls react查看所有依赖的React版本，找到冲突的包后，要么升级该包到适配React 18的版本，要么临时移除该包测试构建是否正常。
验证基础路由文件结构
即使是简单模板，也要确认layout.tsx和page.tsx符合App Router的要求。比如根layout.tsx必须包含<html>和<body>标签：
```
export default function RootLayout({
  children,
}: {
  children: React.ReactNode;
}) {
  return (
    <html lang="en">
      <body>{children}</body>
    </html>
  );
}
```
确保文件中没有错误导入或使用不兼容的React API。
简化next.config.js配置测试
自定义的webpack配置或其他next.config.js设置可能干扰构建。尝试暂时移除所有自定义配置，使用默认配置重新执行npm run build，看是否能正常完成构建。