Expo极简项目出现‘Could not find the Realm binary’错误求助

云原生阿岚

2026-7-5

解决Expo项目中Realm的“Could not find the Realm binary”错误

以下是针对该问题的针对性排查和修复步骤，覆盖文档外的常见遗漏点：

1. 强制确认版本兼容性

Realm与Expo的版本绑定严格，务必确保：

realm 版本 ≥12.0.0 时，expo 版本 ≥48.0.0
已安装 expo-dev-client（Realm不支持Expo Go，必须用自定义开发客户端）
检查你的package.json，如果版本不匹配，执行：

npm install realm@latest expo-dev-client@latest

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

缓存残留是这类问题的高发原因，执行以下完整流程：

删除依赖和锁文件：

rm -rf node_modules package-lock.json yarn.lock

重新安装依赖：
```
npm install
```

清理Expo缓存并重新预构建：

npx expo start --clear
npx expo prebuild --clean

3. 验证预构建后的原生配置

预构建完成后，手动检查原生配置是否正确生成：

iOS：打开ios/Podfile，确认包含pod 'RealmSwift'，然后执行cd ios && pod install --repo-update
Android：打开android/build.gradle，确认repositories块包含mavenCentral()，dependencies块包含implementation 'io.realm:realm-android-library:xxx'（xxx为对应Realm版本）

4. 使用正确的启动方式

绝对不能用Expo Go启动，必须使用原生开发客户端：

iOS：
```
npx expo run:ios
```
Android：
```
npx expo run:android
```

5. 检查Realm初始化代码

确保你的Realm初始化逻辑没有错误，比如：

import Realm from 'realm';

// 数据模型定义
const TaskSchema = {
  name: 'Task',
  properties: {
    id: { type: 'string', indexed: true },
    title: 'string',
  },
  primaryKey: 'id',
};

// 异步初始化（推荐方式）
async function initRealm() {
  const realm = await Realm.open({ schema: [TaskSchema] });
  console.log('Realm initialized');
  return realm;
}

// 在组件中调用
useEffect(() => {
  initRealm();
}, []);

避免同步初始化（new Realm(...)）可能导致的加载时序问题。