Android Room 数据库自动升级与迁移策略

前序

在 Android 应用开发中，Room 是 Google 提供的一个轻量级数据库框架，用于简化与 SQLite 的交互。在应用的迭代过程中，数据库的结构不可避免地会发生变化，因此，我们需要为数据库升级、降级以及数据迁移制定一套合适的策略。

本文将介绍 Room 数据库升级的几种场景和常见的处理方法，包括手动迁移和自动迁移的策略。

何时需要升级数据库版本号？

以下几种情况会导致数据库结构的变更，因此必须升级数据库版本号，并处理相应的迁移逻辑：

1. 新增或删除表：当我们向数据库中添加或删除一张表时，必须升级版本号，并实现相应的迁移处理逻辑，以确保数据的一致性。

2. 新增、删除或修改字段：当对表中的字段进行操作时，例如新增一个列、删除或重命名列，必须升级数据库版本号，同时处理好字段的迁移或初始化逻辑。

3. 修改索引或约束：如果为某些字段添加索引，或者对字段的约束（如非空、唯一等）进行修改，同样需要升级版本号。

Room 数据库迁移策略

Room 提供了多种处理数据库迁移的方式，开发者可以根据项目需求选择合适的迁移策略：

1. fallbackToDestructiveMigration 删除数据库并重建

如果应用中的数据不重要，或者我们允许用户丢失数据库中的所有数据，可以使用 fallbackToDestructiveMigration 方法，该方法会在版本号发生变化时直接删除数据库并重建。

private static AppDatabase create(final Context context) {
   
   
    return Room.databaseBuilder(
            context,
            AppDatabase.class,
            "AppDatabase.db")
        .fallbackToDestructiveMigration() // 自动删除并重建数据库
        .build();
}

注意：使用这种方式，所有的旧数据都会被删除，因此适合那些对数据持久性要求不高的场景。

2. addMigrations 自定义迁移逻辑

当需要保留用户数据时，可以通过自定义 Migration 来处理数据库结构变更。例如，给 user 表新增一个 testId 字段：

public static final Migration MIGRATION_2_3