Realm数据库迁移设主键报错：字段重复致应用崩溃咨询

这个报错的核心原因很明确——你要设为主键的字段，在用户的现有Realm数据里存在重复值，而Realm要求主键必须是唯一的。本地测试正常是因为你的测试数据里该字段没有重复，但用户的旧数据（不管是版本更新遗留的还是重装后残留的）里有重复条目，触发了这个约束检查。

下面给你两种针对性的解决方案，根据你的业务场景选择：

方案1：清理重复数据后设置原字段为主键 #

如果这个字段本来就应该是唯一标识（比如业务上的taskId），只是旧数据因为之前的逻辑漏洞出现了重复，那可以先删除重复条目，再设置主键：

public class TasksMigration implements RealmMigration {
    @Override
    public void migrate(DynamicRealm realm, long oldVersion, long newVersion) {
        final RealmSchema schema = realm.getSchema();
        
        // 假设从版本0升级到版本1，需要设置taskId为主键
        if (oldVersion < 1) {
            // 第一步：找出并删除重复的taskId条目
            RealmResults<DynamicRealmObject> tasks = realm.where("Task").findAll();
            Map<String, DynamicRealmObject> uniqueTaskMap = new HashMap<>();
            
            for (DynamicRealmObject task : tasks) {
                String taskId = task.getString("taskId");
                if (!uniqueTaskMap.containsKey(taskId)) {
                    uniqueTaskMap.put(taskId, task);
                } else {
                    // 删除重复的条目（这里可以根据业务保留最新/最早的条目）
                    task.deleteFromRealm();
                }
            }
            
            // 第二步：设置字段为主键，并设为非空
            schema.get("Task")
                  .addPrimaryKey("taskId")
                  .setNullable("taskId", false);
            
            oldVersion = 1;
        }
        
        // 其他版本迁移逻辑...
    }
}

方案2：新增唯一字段作为主键 #

如果原字段本身不适合作为唯一主键（比如业务上允许重复），那建议新增一个全局唯一的字段（比如UUID生成的id），再将其设为主键：

public class TasksMigration implements RealmMigration {
    @Override
    public void migrate(DynamicRealm realm, long oldVersion, long newVersion) {
        final RealmSchema schema = realm.getSchema();
        
        if (oldVersion < 1) {
            // 第一步：新增非空的id字段
            schema.get("Task")
                  .addField("id", String.class)
                  .setNullable("id", false);
            
            // 第二步：为现有数据生成唯一ID
            RealmResults<DynamicRealmObject> tasks = realm.where("Task").findAll();
            for (DynamicRealmObject task : tasks) {
                task.setString("id", UUID.randomUUID().toString());
            }
            
            // 第三步：设置新字段为主键
            schema.get("Task")
                  .addPrimaryKey("id");
            
            oldVersion = 1;
        }
        
        // 其他版本迁移逻辑...
    }
}

关键注意事项 #

• 模拟用户数据测试：一定要在本地构造包含重复字段的测试数据，验证迁移逻辑是否能正常执行，避免只在干净数据上测试。
• 数据备份：迁移操作会修改用户数据，建议在迁移前提示用户备份，或者在代码中做数据备份逻辑。
• 重装场景处理：有些设备会保留应用的缓存数据，即使用户重装应用，旧的Realm文件可能依然存在，所以迁移逻辑必须覆盖所有可能的旧版本情况。

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