Android Realm迁移异常处理：遇RealmMigrationNeededException时重建数据库

我来帮你完善这个Realm迁移时重建数据库的逻辑，直接上完整可用的代码并给你拆解说明：

这种方式适合需要自定义异常处理逻辑的场景，代码如下：

// 先确保你的Migration类已实现（即使暂时不需要写迁移逻辑）
public class Migration implements RealmMigration {
    @Override
    public void migrate(DynamicRealm realm, long oldVersion, long newVersion) {
        // 注：如果后续需要保留旧数据做迁移，在这里编写具体版本升级逻辑
        // 当前我们是删库重建，所以这里可以留空
    }
}

// 核心配置与初始化逻辑
RealmConfiguration realmConfiguration = new RealmConfiguration.Builder()
        .schemaVersion(3) // 当前数据库版本号
        .migration(new Migration()) // 绑定自定义Migration类
        .build();

Realm realm = null;
try {
    // 尝试初始化Realm
    realm = Realm.getInstance(realmConfiguration);
} catch (RealmMigrationNeededException e) {
    // 捕获到迁移需求异常时，删除旧数据库
    Realm.deleteRealm(realmConfiguration);
    // 删除后重新初始化，得到新结构的数据库
    realm = Realm.getInstance(realmConfiguration);
} finally {
    // 确保Realm实例被正确关闭，避免内存泄漏
    if (realm != null && !realm.isClosed()) {
        realm.close();
    }
}

关键细节说明 #

• Migration类的作用：即使我们选择删库重建，Realm依然要求配置Migration类（因为指定了schemaVersion），它是版本升级的必要绑定项。后续如果需要保留旧数据，直接在migrate方法里编写字段新增、表结构修改等逻辑即可。
• 异常处理逻辑：当本地数据库版本低于配置的schemaVersion时，会抛出RealmMigrationNeededException，此时调用Realm.deleteRealm()会彻底删除旧数据库的所有文件，重新初始化后就能得到符合新schema的空数据库。
• 资源释放：用finally块确保Realm实例被关闭，这是Realm开发的基础规范，避免内存泄漏问题。

如果不需要自定义异常处理，Realm提供了更简洁的自动删库方案，一行代码搞定：

RealmConfiguration realmConfiguration = new RealmConfiguration.Builder()
        .schemaVersion(3)
        .deleteRealmIfMigrationNeeded() // 自动处理迁移需求，直接删库重建
        .build();

Realm realm = Realm.getInstance(realmConfiguration);
// 使用完成后记得关闭实例
realm.close();

这个API内部已经封装了异常捕获和删库逻辑，效果和手动处理完全一致，适合不需要额外异常处理的场景，代码更简洁。

重要提醒 #

无论是哪种方案，删库重建都会丢失所有本地数据，请确认你的业务场景允许这么做。如果需要保留旧数据，必须放弃删库方案，在Migration类的migrate方法中编写具体的版本迁移逻辑（比如从版本2到3新增字段、修改索引等）。

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