Expo SDK版本升级失败及与Expo Go兼容问题求助

核心问题分析 #

• 跨大版本直接升级（44→47）极易引发依赖冲突
• 旧版expo-cli（5.1.3）不支持高版本SDK的升级流程
• 项目混合了React Navigation v5和v6包，存在版本冲突
• yarn缓存或锁文件异常导致安装失败

分步解决方案 #

1. 升级全局expo-cli到最新版 #

旧版cli无法处理跨大版本升级，先执行：

npm install -g expo-cli@latest

2. 备份项目并提交代码 #

升级前务必提交当前修改，避免升级失败无法回滚：

git add .
git commit -m "Backup before SDK upgrade"

3. 分步升级SDK（避免跨版本冲突） #

不要直接跳级到47，按顺序升级：

1. 升级到SDK45：

expo upgrade 45

• 执行后检查依赖安装情况，修复报错，确保项目能正常启动

2. 升级到SDK46：

expo upgrade 46

• 同样解决依赖冲突，验证项目运行状态

3. 最后升级到SDK47：

expo upgrade 47

4. 切换npm解决yarn安装失败问题 #

如果yarn持续报错，尝试用npm替代：

1. 删除yarn.lock和node_modules：

rm -rf node_modules yarn.lock

2. 用npm执行升级：

expo upgrade --npm

5. 手动修复依赖冲突 #

移除不必要的依赖

将expo-cli从package.json的dependencies中移除，它应该全局安装，不需要留在项目依赖里。

统一React Navigation版本

项目中混合了v5和v6的导航包（如@react-navigation/material-top-tabs是v6，其余为v5），这会导致兼容问题。建议全部升级到v6：

• 卸载v5的导航包：

npm uninstall @react-navigation/native @react-navigation/stack @react-navigation/material-bottom-tabs react-navigation-stack

• 安装v6核心包及所需导航组件：

npm install @react-navigation/native @react-navigation/stack @react-navigation/material-bottom-tabs @react-navigation/material-top-tabs

• 同步安装v6所需的依赖：

npm install react-native-screens react-native-safe-area-context

调整核心依赖版本（匹配SDK47要求）

确保以下核心依赖版本符合SDK47规范：

"react": "18.1.0",
"react-native": "0.70.5",
"react-dom": "18.1.0",
"expo": "^47.0.0",

检查第三方库兼容性

部分第三方库需要升级到兼容SDK47的版本：

• @gorhom/bottom-sheet: 升级到v4+
• native-base: 升级到v3.4+
• react-native-reanimated: 升级到~2.12.0
• react-native-svg: 升级到~13.4.0

6. 验证升级结果 #

执行以下命令确保项目能正常启动：

expo start --clear

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