Expo eject转bare后iOS构建卡启动屏报expo-updates配置错误
报错原因与解决步骤
该报错的核心触发原因是expo-updates原生模块初始化时,未通过配置校验:启用状态下缺少必填的更新地址(url)或作用域标识(scopeKey),属于managed workflow转bare workflow(即执行eject/预构建操作)时的配置遗漏。
一、按你的使用需求修改expo-updates配置
场景1:不需要使用OTA热更新能力
- 方案A:保留模块但禁用校验
- 在项目根目录的
app.json/app.config.js的expo配置块下添加如下配置:"updates": { "enabled": false } - 检查iOS目录下的
Info.plist,找到EXUpdatesConfiguration分类下的EXUpdatesURL、EXUpdatesScopeKey键值,若存在残留的占位内容则清空/删除该项,避免触发校验逻辑。
- 在项目根目录的
- 方案B:彻底移除依赖(更适合不需要热更新的打包场景)
- 直接执行命令移除依赖:
npm uninstall expo-updates - 后续执行pod安装操作即可,原生层不会再加载该模块的初始化逻辑。
- 直接执行命令移除依赖:
场景2:需要保留OTA热更新能力
- 必须在
app.json/app.config.js的expo.updates节点下补全必填参数,示例配置如下:"updates": { "enabled": true, "url": "匹配你更新服务的访问地址", "runtimeVersion": { "policy": "appVersion" } } scopeKey会在配置完合法url后,由Expo CLI自动生成并同步到原生层,无需手动修改原生文件硬编码。
二、配置修改后的必执行操作
- 运行
npx expo config --type prebuild将修改后的配置同步到原生项目文件,避免直接修改原生配置导致后续冲突。 - 进入
ios目录重新执行pod install,保证原生依赖读取到最新的配置项。 - 完全关闭Xcode,删除模拟器上已安装的旧版本应用,执行Xcode清除构建缓存(快捷键
Cmd+Shift+K)后再重新构建运行,避免旧构建产物残留旧配置。
常见遗漏注意点
执行eject操作时,若跳过了EAS Update的初始化配置流程,Expo CLI会自动给expo-updates写入占位配置但不填充实际参数,直接触发原生层校验失败,这是该类报错的最高发原因。
内容的提问来源于stack exchange,提问作者Peter J
相关产品推荐
相关产品推荐

