Expo启动iOS项目遇Missing Realm constructor报错，求解决方法

问题详情 #

每次启动Expo服务器时，iOS端出现以下报错，问题始于安装Realm后，多次执行pod install无效：

WARN Constants.platform.ios.model已被弃用，建议使用expo-device的Device.modelName属性，该API将在SDK 45中移除。
ERROR Error: Missing Realm constructor. Did you run "pod install"? js engine: hermes
ERROR Invariant Violation: "main"未注册，可能原因：

• Metro（本地开发服务器）在错误目录运行，请检查Metro状态，停止后在当前项目重启。
• 模块加载失败导致未调用AppRegistry.registerComponent，js engine: hermes。

已尝试但无效的操作：

• 安装Hermes
• 重装Node、NVM和NPM
• 升降级React Native版本
• 卸载重装Node Module和package-lock.json
• 修改index.js注册main组件

针对性解决方案 #

1. 校验版本兼容性 #

Realm对React Native/Expo版本有严格依赖，确认当前Realm版本与你的Expo SDK或React Native版本匹配。例如：

• Expo SDK 49+ 需搭配Realm 12.x及以上版本
• React Native 0.72+ 需Realm 11.x+版本
  版本不匹配会导致原生模块无法正确编译，可通过调整package.json中的Realm版本后重新安装依赖。

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

执行以下步骤清理所有缓存文件，避免旧缓存干扰：

• 关闭Metro服务器和Xcode
• 删除iOS目录下的Pods文件夹、Podfile.lock文件以及build文件夹
• 执行npx pod-install（使用项目关联的Node环境执行，而非全局pod install）
• 打开Xcode，点击Product > Clean Build Folder，再重新构建项目

3. 修正Expo项目的Realm配置（Managed项目适用） #

若使用Expo托管式项目，需确保Realm配置正确：

• 安装expo-dev-client：npm install expo-dev-client
• 在app.json中添加Realm插件配置：

{
  "expo": {
    "plugins": [["@realm/react-native", { "schemaVersion": 1 }]]
  }
}

• 执行npx expo prebuild --clean重新生成原生项目文件

4. 调整Realm导入顺序修复组件注册问题 #

"main"未注册通常是Realm加载失败导致AppRegistry未执行，调整导入顺序：

• 在index.js或App.js的最顶部导入Realm，避免异步导入延迟初始化
• 确认AppRegistry.registerComponent('main', () => App)代码位于文件末尾，且未被条件语句包裹

5. 确保Hermes与Realm兼容 #

若启用Hermes，需检查配置并重新编译：

• 在iOS目录的Podfile中确认Hermes开启：

use_react_native!(
  :path => config[:reactNativePath],
  # 其他配置...
  :hermes_enabled => true
)

• 执行npx pod-install后，清理Xcode缓存并重新构建项目

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