将在线优先React Native应用迁移至MongoDB Realm离线优先架构：用户关联原有MongoDB数据的实现问题

我完全懂你现在的困扰——把在线应用转成Realm离线优先模式，最棘手的就是把旧的MongoDB用户数据和新的Realm用户体系衔接起来。你说的没错，一开始在Realm App Services里手动创建用户确实能登录，但没法直接关联旧数据，不过有几个靠谱的方案可以解决这个问题：

方案一：通过唯一标识批量关联旧数据 #

如果你的旧MongoDB用户数据里有和Realm用户一致的唯一标识（比如邮箱、用户名），这是最直接的办法：

1. 配置Realm数据访问规则：在App Services里找到你的目标数据集合，设置规则让用户只能访问自己的数据。比如用邮箱作为关联字段，规则可以写：

   {
     "read": { "owner_email": "%%user.data.email" },
     "write": { "owner_email": "%%user.data.email" }
   }
   

   这里的%%user是Realm的内置变量，代表当前登录的用户，%%user.data.email就是该用户在Realm里的邮箱。
2. 批量更新旧数据：在MongoDB Atlas的shell里执行批量更新，给每个旧数据文档加上关联字段（比如owner_email），值对应Realm用户的邮箱。假设旧数据里的用户邮箱存在user.email字段，命令如下：

   db.your_business_collection.updateMany(
     {},
     [{ $set: { owner_email: "$user.email" } }]
   )
   

3. 验证效果：用户登录Realm后，通过SDK查询数据时，Realm会自动根据规则过滤出属于该用户的文档，离线同步也会只同步这些数据。

方案二：用Realm自定义用户数据绑定旧用户文档 #

Realm自带的自定义用户数据功能可以直接把Realm用户和旧MongoDB里的用户文档绑定：

1. 配置自定义用户数据：进入App Services → 用户 → 自定义用户数据，选择你存储旧用户信息的集合，然后设置匹配字段（比如Realm用户的email对应旧集合的email字段），勾选“自动关联现有数据”（不用创建新文档，直接绑定已有的）。
2. 在App中获取关联数据：用户登录后，你可以直接通过Realm SDK获取到绑定的旧用户数据，再用它查询业务数据：

   // React Native示例代码
   import { useRealm, useApp } from '@realm/react';
   
   const MyComponent = () => {
     const app = useApp();
     const realm = useRealm();
     const currentUser = app.currentUser;
   
     if (currentUser) {
       // 获取绑定的旧用户数据
       const oldUserData = currentUser.customData;
       // 查询该用户的业务数据（假设业务集合用userId关联旧用户的_id）
       const userBusinessData = realm.objects('BusinessCollection').filtered('userId == $0', oldUserData._id);
     }
   };
   

方案三：导入旧用户凭证到Realm认证系统 #

如果你之前用的是邮箱密码登录，可以把旧用户直接导入Realm的认证系统，让用户用原有账号登录：

1. 启用邮箱/密码认证：在App Services → 认证 → 邮箱/密码，启用该认证提供者。
2. 批量导入用户：用Realm Admin SDK批量导入旧用户的邮箱和密码（注意：如果旧密码是加密存储的，比如bcrypt，需要先解密，或者引导用户重置密码）。示例代码：

   const { Realm } = require('realm');
   const adminApp = new Realm.App({ id: '你的App ID' });
   const adminCredentials = Realm.Credentials.apiKey('你的Admin API Key');
   
   async function importOldUsers() {
     const adminUser = await adminApp.logIn(adminCredentials);
     const oldUsersCollection = adminUser.mongoClient('mongodb-atlas').db('你的数据库').collection('旧用户集合');
     const oldUsers = await oldUsersCollection.find();
   
     for (const user of oldUsers) {
       try {
         await adminApp.emailPasswordAuth.registerUser({
           email: user.email,
           password: user.plainTextPassword // 如果是加密密码，这里需要处理
         });
       } catch (err) {
         console.log(`导入用户${user.email}失败:`, err);
       }
     }
   }
   

3. 用户直接登录：用户现在可以用原来的邮箱密码登录Realm，登录后直接通过规则或自定义数据访问自己的旧数据。

一些注意事项 #

• 迁移前一定要在测试环境验证，避免影响生产数据；
• 如果用规则关联，要确保Realm用户的标识和旧数据的标识完全匹配，比如邮箱大小写要一致；
• 离线同步前，要确保Realm Schema和旧MongoDB的集合结构匹配，必要时做字段映射。

备注：内容来源于stack exchange，提问作者louis