Next.js V13无法运行，求助Invalid hook call错误解决方案

一、核心排查方向 #

• 版本兼容性检查：Next.js对React版本有硬性要求，比如Next.js 13+必须搭配React 18.x。打开package.json确认next、react、react-dom版本匹配，避免跨版本不兼容。
• 重复React实例排查：执行npm ls react或yarn list react，查看输出是否存在多个React依赖实例。若有，先运行npm dedupe自动合并重复依赖，无效则手动删除node_modules和锁文件后重装。
• Hook调用位置校验：哪怕恢复了初始代码，再仔细核对：所有Hook必须在函数组件顶层调用，不能放在条件判断、循环、嵌套函数里；自定义Hook也要遵循此规则，禁止在非组件环境调用。
• 自定义Hook导出/导入检查：确认自定义Hook是标准函数声明，导入时不要混淆默认导出和命名导出，别把Hook当普通函数使用。
• Next.js特殊规则检查：若用Pages Router，pages目录下的组件必须是默认导出；若用App Router，注意Server Components不能用Hook，需在组件顶部加'use client'指令才能使用Hook。

二、彻底卸载重装Next.js的步骤 #

• 卸载项目内相关依赖：

  npm uninstall next react react-dom
  # Yarn用户执行
  yarn remove next react react-dom
  

• 移除全局安装的Next.js（若之前装过全局版）：

  npm uninstall -g next
  yarn global remove next
  

• 清理残留文件：删除项目根目录的node_modules文件夹、package-lock.json/yarn.lock锁文件，以及.next构建缓存文件夹。
• 重新安装匹配版本的依赖：比如安装最新稳定版：

  npm install next@latest react@latest react-dom@latest
  # Yarn用户执行
  yarn add next@latest react@latest react-dom@latest
  

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