Expo SDK 46升级至SDK 50后iOS端出现Invariant Violation运行时错误

问题重现 #

将Expo SDK 46通过Metro升级至SDK 50后，Web应用运行正常，但iOS构建完成后无法启动，调试器输出以下错误：

Invariant Violation: Failed to call into JavaScript module method RCTLog.logIfNoNativeHook(). Module has not been registered as callable. Bridgeless Mode: false. Registered callable JavaScript modules (n = 0): .
        A frequent cause of the error is that the application entry file path is incorrect. This can also happen when the JS bundle is corrupt or there is an early initialization error when loading React Native., js engine: hermes
Invariant Violation: Failed to call into JavaScript module method AppRegistry.runApplication(). Module has not been registered as callable. Bridgeless Mode: false. Registered callable JavaScript modules (n = 0): .
        A frequent cause of the error is that the application entry file path is incorrect. This can also happen when the JS bundle is corrupt or there is an early initialization error when loading React Native., js engine: hermes
Invariant Violation: Failed to call into JavaScript module method RCTLog.logIfNoNativeHook(). Module has not been registered as callable. Bridgeless Mode: false. Registered callable JavaScript modules (n = 0): .
        A frequent cause of the error is that the application entry file path is incorrect. This can also happen when the JS bundle is corrupt or there is an early initialization error when loading React Native., js engine: hermes
Invariant Violation: Failed to call into JavaScript module method HMRClient.setup(). Module has not been registered as callable. Bridgeless Mode: false. Registered callable JavaScript modules (n = 0): .
        A frequent cause of the error is that the application entry file path is incorrect. This can also happen when the JS bundle is corrupt or there is an early initialization error when loading React Native., js engine: hermes
Invariant Violation: No callback found with cbID 2 and callID 1 for module <unknown>. Args: '[{"app_state":"active"}]', js engine: hermes
Invariant Violation: Failed to call into JavaScript module method RCTDeviceEventEmitter.emit(). Module has not been registered as callable. Bridgeless Mode: false. Registered callable JavaScript modules (n = 0): .
        A frequent cause of the error is that the application entry file path is incorrect. This can also happen when the JS bundle is corrupt or there is an early initialization error when loading React Native., js engine: hermes

排查与修复步骤 #

1. 校验入口文件配置 #

• 检查 app.json 中的 entryPoint 字段，确认路径指向正确的入口文件（通常是 index.js 或 App.js），路径格式要符合iOS文件系统要求，避免相对路径错误。
• 确保入口文件中正确注册了应用：

  import { AppRegistry } from 'react-native';
  import App from './App';
  import { name as appName } from './app.json';
  
  AppRegistry.registerComponent(appName, () => App);
  

2. 清理缓存并重新构建 #

• 清除Metro缓存：

  npx expo start --clear
  

• 清除iOS构建缓存：

  cd ios && pod deintegrate && pod install && cd ..
  rm -rf ~/Library/Caches/CocoaPods
  rm -rf ios/Pods
  rm -rf ios/build
  

• 重新执行构建命令：

  npx expo run:ios
  

3. 检查Hermes配置冲突 #

• 确认 app.json 中Hermes的启用配置正确，SDK 50默认启用Hermes，若手动修改过相关配置，恢复默认设置：

  "ios": {
    "jsEngine": "hermes"
  }
  

• 检查是否有第三方库未适配Hermes，暂时切换到JSC测试是否能启动：

  "ios": {
    "jsEngine": "jsc"
  }
  

4. 排查初始化阶段错误 #

• 在入口文件最顶部添加错误捕获，排查是否有早期初始化异常：

  try {
    // 原入口文件代码
  } catch (error) {
    console.error('初始化错误:', error);
    // 若使用Expo，可通过Expo Logs查看
    import('expo-logs').then(({ Logs }) => Logs.logError(error));
  }
  

• 逐一注释第三方库初始化代码，定位是否有库在iOS环境下导致加载失败。

5. 确认SDK升级完整性 #

• 对照Expo官方升级指南，检查是否遗漏了依赖更新或配置修改：
  • 确保所有Expo相关依赖（如 expo, expo-* 包）版本统一为SDK 50对应版本。
  • 检查 package.json 中 react-native 版本是否与SDK 50兼容（SDK 50对应react-native 0.72.6）。

6. 检查构建模式差异 #

• 若使用开发构建，确认是否开启了正确的调试模式；若为生产构建，检查是否存在代码压缩导致的模块丢失问题：
  • 尝试关闭生产构建的代码混淆，测试是否能正常启动。

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