如何预填充Realm数据库？React Native加载JSON数据及流程咨询

能不能直接从JSON文件加载到Realm？ #

可以，但不是直接"导入文件"——Realm需要你先把JSON内容解析成JavaScript对象，再批量写入对应的Realm模型实例。不需要修改原始JSON文件（只要字段和你的Realm模型匹配就行），下面是具体步骤：

1. 准备工作：安装Realm并定义数据模型 #

首先确保你已经安装了Realm依赖：

npm install realm
# 或者用yarn
yarn add realm

然后定义对应你爬取数据的Realm模型，比如你的JSON是商品列表，就创建一个Item模型：

// models/Item.js
import { Realm } from 'realm';

export class Item extends Realm.Object {}
Item.schema = {
  name: 'Item',
  properties: {
    id: 'int',          // 对应JSON里的id字段
    title: 'string',    // 对应标题
    crawlTime: 'date?', // 可选的爬取时间，支持日期类型
    content: 'string?'  // 可选的内容字段
  },
  primaryKey: 'id', // 设置主键，避免重复导入
};

2. 读取JSON文件：分两种场景处理 #

场景A：JSON文件打包在APP安装包内 #

如果你的爬取数据是提前准备好、随APP打包的，直接用require引入即可，React Native会自动帮你解析JSON：

// 假设JSON放在项目根目录的assets/data/crawl_data.json
const rawCrawlData = require('../assets/data/crawl_data.json');
// 这里rawCrawlData已经是解析好的JavaScript数组/对象，不需要再JSON.parse

注意路径是相对于当前脚本的相对路径，和你引入图片的规则一致。

场景B：JSON文件存在设备本地存储（比如下载/生成的） #

如果数据是运行时生成或下载到设备的，需要用文件系统库读取，推荐react-native-fs：
先安装依赖：

npm install react-native-fs

然后读取文件并解析：

import RNFS from 'react-native-fs';

async function loadCrawlDataFromStorage() {
  // 示例：文件存放在设备的Documents目录下
  const filePath = `${RNFS.DocumentDirectoryPath}/crawl_data.json`;
  
  try {
    // 读取文件内容
    const fileContent = await RNFS.readFile(filePath, 'utf8');
    // 解析成JavaScript对象
    const parsedData = JSON.parse(fileContent);
    return parsedData;
  } catch (error) {
    console.error('读取存储文件失败:', error);
    return []; // 出错返回空数组兜底
  }
}

3. 将解析后的数据写入Realm #

拿到解析好的数据后，就可以批量写入Realm了：

import { Realm } from 'realm';
import { Item } from './models/Item';

async function importDataToRealm(crawlData) {
  // 打开Realm数据库
  const realm = await Realm.open({
    schema: [Item],
    // 如果后续修改模型，需要递增schemaVersion
    // schemaVersion: 1,
  });

  try {
    // 写入操作必须在write事务里执行
    realm.write(() => {
      crawlData.forEach(item => {
        // 第三个参数是更新模式：如果主键存在就更新，不存在就创建
        realm.create('Item', item, Realm.UpdateMode.Modified);
      });
    });
    console.log('数据导入Realm成功！');
  } catch (error) {
    console.error('写入Realm失败:', error);
  } finally {
    // 记得关闭Realm连接
    realm.close();
  }
}

调用的时候很简单：

// 打包文件场景
importDataToRealm(rawCrawlData);

// 存储文件场景
loadCrawlDataFromStorage().then(data => {
  importDataToRealm(data);
});

React Native数据处理通用工作流程 #

一般我处理这类数据会遵循以下步骤：

• 步骤1：确定数据源：明确数据是打包在APP内、设备存储还是网络接口
• 步骤2：获取/读取数据：用require（打包文件）、react-native-fs（设备存储）或fetch/axios（网络）获取原始数据
• 步骤3：解析与校验：解析JSON（如果需要），并校验字段是否符合本地存储模型的要求（可以用Zod这样的库做schema校验，避免写入报错）
• 步骤4：写入本地存储：将处理好的数据写入Realm/MMKV/AsyncStorage等
• 步骤5：UI层消费数据：从本地存储查询数据，在组件中展示（比如用Realm的useQuery钩子监听数据变化）

应该在通用脚本还是平台项目处理？ #

优先在React Native的通用JS/TS脚本里处理！Realm本身是跨平台库，react-native-fs也支持iOS和Android，大部分场景不需要写原生代码。只有当你需要处理平台特定的文件权限（比如Android 13+的媒体权限、iOS的iCloud文件访问）时，才需要在原生项目里配置权限或写原生模块，核心的数据读取、解析、写入逻辑都可以放在通用脚本里。

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