使用RecoilState库遇运行时错误：ReactCurrentDispatcher解构失败

问题描述 #

开发时持续遇到运行时错误：

Unhandled Runtime Error
TypeError: Cannot destructure property 'ReactCurrentDispatcher' of '{imported module [project]/nodemodules/next/dist/compiled/react/index.js [app-client] (ecmascript)}.default.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED' as it is undefined.

当前环境：Next.js 15、React 19，已尝试降级React、删除重装node_modules，问题未解决。

可行解决方案 #

1. 移除手动安装的React依赖，使用Next.js内置版本 #

Next.js 15自带适配的React编译包，手动安装的React 19会和内置版本冲突，导致内部API无法正常访问：

• 执行卸载命令：

  # npm
  npm uninstall react react-dom
  # yarn
  yarn remove react react-dom
  # pnpm
  pnpm remove react react-dom
  

• 打开package.json，确认dependencies中没有react和react-dom条目。

2. 彻底清理依赖缓存与残留 #

残留的依赖缓存可能导致版本不一致：

• 删除node_modules：

  # Mac/Linux
  rm -rf node_modules
  # Windows
  rd /s /q node_modules
  

• 删除锁文件：

  rm package-lock.json yarn.lock pnpm-lock.yaml
  

• 重新安装依赖：

  npm install # 或 yarn install / pnpm install
  

3. 排查Next.js配置中的自定义React设置 #

如果next.config.js中有修改React相关的实验性配置，可能引发兼容性问题：

• 注释掉experimental.reactRoot、experimental.serverActions等自定义React配置项
• 重启开发服务器，观察错误是否消失

4. 检查第三方依赖的兼容性 #

部分第三方库未适配React 19的内部API变更，会触发该错误：

• 临时注释掉项目中的第三方组件，逐个排查定位问题库
• 将问题库更新到最新版本，或替换为兼容React 19的替代方案

5. 尝试Next.js Canary版本 #

Next.js 15的稳定版可能存在React 19兼容漏洞，Canary版本通常包含最新修复：

npm install next@canary

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