Room结合createFromAsset与fallbackToDestructiveMigration重复建库问题求解

核心思路是手动对比本地数据库版本与代码中定义的版本，仅当版本确实升级时才删除旧库，让Room从Asset重新复制新库，同时保留兜底的迁移销毁逻辑。

步骤1：编写工具方法获取本地数据库版本 #

用于读取设备上已存在的数据库文件版本：

private static int getLocalDatabaseVersion(Context context, String dbName) {
    SQLiteDatabase db = null;
    int version = 0;
    try {
        File dbFile = context.getDatabasePath(dbName);
        if (dbFile.exists()) {
            db = SQLiteDatabase.openDatabase(dbFile.getPath(), null, SQLiteDatabase.OPEN_READONLY);
            version = db.getVersion();
        }
    } catch (SQLException e) {
        e.printStackTrace();
    } finally {
        if (db != null && db.isOpen()) {
            db.close();
        }
    }
    return version;
}

步骤2：修改Database Provider逻辑 #

在构建Room数据库前，先判断版本是否需要升级，再决定是否删除旧库：

@Module
@InstallIn(SingletonComponent.class)
public class TestRoomModule {

    private static final String DATABASE_NAME = "test.db";

    @Provides
    public TestDatabase provideDatabase(@ApplicationContext Context context) {
        // 获取代码中定义的当前数据库版本
        int currentAppVersion = TestDatabase.class.getAnnotation(Database.class).version();
        // 获取设备上已存在的数据库版本
        int localDbVersion = getLocalDatabaseVersion(context, DATABASE_NAME);

        // 仅当本地版本低于当前版本时，删除旧数据库
        if (localDbVersion > 0 && localDbVersion < currentAppVersion) {
            context.deleteDatabase(DATABASE_NAME);
        }

        return Room.databaseBuilder(
                        context.getApplicationContext(),
                        TestDatabase.class,
                        DATABASE_NAME)
                .createFromAsset("databases/test.db")
                // 保留兜底逻辑，防止版本判断异常导致的迁移报错
                .fallbackToDestructiveMigration()
                .allowMainThreadQueries() // 生产环境建议移除
                .build();
    }
}

为什么这能解决问题？ #

• 首次安装：本地无数据库，Room直接从Asset复制最新库，正常初始化。
• 版本升级：本地旧版本 < 当前代码版本，删除旧库后，Room自动从Asset复制新版本库，完成升级。
• 版本一致：本地版本与代码版本匹配，不删除旧库，Room直接复用已有的数据库，不会触发不必要的重建。

注意事项 #

1. 确保Asset目录下的test.db版本号与@Database(version = X)完全一致，否则会出现版本不匹配问题。
2. fallbackToDestructiveMigration作为兜底保留，避免因版本读取异常等极端情况导致App崩溃。
3. allowMainThreadQueries仅用于测试，生产环境必须移除，改用Coroutine或LiveData执行异步数据库操作。

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