升级Expo至SDK 45重装后开发者工具报意外错误求助

核心诱因 #

这类问题是SDK45升级过程中的典型故障，通常由三类原因触发：全局expo-cli版本与项目SDK45版本不兼容、yarn依赖安装时版本锁冲突、旧版本构建/运行缓存未清理、Node版本不符合SDK45的运行要求。SDK45是Expo切换到本地expo包替代全局expo-cli的过渡版本，旧的全局安装习惯非常容易触发这类连锁报错。

分步修复操作 #

• 第一步：清理所有残留进程与损坏缓存
  先强制终止所有相关后台进程，避免文件占用导致清理失败：
  pkill -f node && pkill -f expo && pkill -f metro
  依次执行以下命令清理缓存和损坏的依赖文件：

  yarn cache clean
  rm -rf node_modules yarn.lock .expo
  # 完全卸载全局安装的旧版expo-cli，避免全局命令优先级干扰
  yarn global remove expo-cli expo
  

  注意：SDK45及后续版本官方不再推荐全局安装expo-cli，全局版本和项目本地SDK版本不一致是这版升级最常见的故障源。

• 第二步：安装对齐SDK45版本的依赖
  进入项目根目录，执行官方版本修复命令，该命令会自动把所有Expo生态依赖（包括react-native、react、各expo插件）调整到和SDK45完全兼容的版本号，不要手动指定这些包的版本：
  npx expo install --fix
  确认package.json内的启动脚本配置正确：

  {
    "scripts": {
      "start": "expo start -c",
      "android": "expo start --android",
      "ios": "expo start --ios",
      "web": "expo start --web"
    }
  }
  

• 第三步：验证启动与移动端连接
  直接调用项目本地的expo命令启动服务，强制清除metro缓存：
  npx expo start
  如果Dev Tools仍然加载异常，手动指定端口避开默认端口的占用冲突：
  npx expo start --port 19005
  移动端侧同步操作：将Expo Go升级到2.25.0及以上版本（对应支持SDK45的最低版本），清除Expo Go内历史保存的开发服务器记录后，重新扫终端内的二维码连接即可。

• 第四步：Node版本兼容排查
  如果以上操作完成后仍然报错，检查本地Node版本：SDK45仅支持Node.js 14.17.0 ~ 16.x 版本范围，Node 17+版本默认的OpenSSL配置变更会直接导致Dev Tools白屏、崩溃。切换Node版本到16.x LTS后，重新执行第一步的缓存清理和依赖安装步骤即可。

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