从Room数据库恢复后单表数据偶发丢失的问题求助

问题场景 #

通过复制db文件备份Room数据库，恢复时执行以下流程：

1. 关闭当前数据库（代码如下），删除原数据库文件（含shm、wal文件）

public void closeDb() {
    if (db != null) {
        if (db.isOpen()) {
            db.getOpenHelper().close();
        }
        db = null;
    }
}

2. 用Java File API将备份的db文件（仅db文件）复制到数据库目录，已确认文件操作成功
3. 调用初始化方法重新打开数据库：

public static DBManager init() {
    if (db == null) {
        db = Room.databaseBuilder(application,
                MyDb.class, dbPath).allowMainThreadQueries().addMigrations(MIGRATION_1_2, MIGRATION_2_3, MIGRATION_3_4, MIGRATION_4_5, MIGRATION_5_6).build();
    }
    return db;
}

执行全程无报错，但偶发某张表数据无法查询；手动删除shm和wal文件并重启应用后，数据可正常查询。尝试恢复db后先打开数据库、再删shm/wal重启，问题仍存在。

核心原因分析 #

问题根源在于Room/SQLite的WAL（Write-Ahead Logging）机制：

• 当数据库以WAL模式运行时，最新的数据可能暂存于wal文件而非主db文件中，直接备份仅db文件会导致数据不完整
• 恢复时，即使删除了原shm/wal文件，重新打开数据库后，SQLite可能会尝试从残留的WAL日志（或错误的日志关联）中恢复数据，导致表数据加载异常
• 备份流程只备份了主db文件，缺少对应时刻的wal和shm文件，这是数据不一致的关键

解决思路与步骤 #

1. 修正备份流程：完整备份所有数据库相关文件 #

备份时必须同时备份db、db-shm、db-wal三个文件，确保数据的一致性：

• 在备份前，先确保数据库完全关闭，避免WAL日志中还有未写入主db的脏数据
• 关闭数据库后，一次性复制所有三个文件到备份目录

2. 优化恢复流程：确保数据库完全清理后再恢复 #

恢复时需严格保证数据库进程完全退出，避免文件被占用或残留：

• 执行closeDb()后，通过File.delete()确认所有原数据库文件都能被删除，确保数据库连接彻底释放
• 删除原目录下的db、db-shm、db-wal所有文件，确认删除成功后，再将备份的三个文件完整复制到目标目录
• 重新初始化数据库

3. 强制数据库校验与WAL日志合并 #

如果仍出现数据异常，可在恢复后打开数据库时，强制SQLite执行日志合并与完整性校验：

public static DBManager init() {
    if (db == null) {
        db = Room.databaseBuilder(application, MyDb.class, dbPath)
                .allowMainThreadQueries()
                .addMigrations(MIGRATION_1_2, MIGRATION_2_3, MIGRATION_3_4, MIGRATION_4_5, MIGRATION_5_6)
                .addCallback(new RoomDatabase.Callback() {
                    @Override
                    public void onOpen(@NonNull SupportSQLiteDatabase db) {
                        super.onOpen(db);
                        // 将WAL日志中的数据强制写入主db文件，并截断日志
                        db.execSQL("PRAGMA wal_checkpoint(TRUNCATE)");
                        // 校验数据库完整性
                        Cursor cursor = db.rawQuery("PRAGMA integrity_check", null);
                        if (cursor.moveToFirst()) {
                            String result = cursor.getString(0);
                            if (!"ok".equals(result)) {
                                // 处理数据库损坏情况，如触发重建或重新恢复备份
                            }
                        }
                        cursor.close();
                    }
                })
                .build();
    }
    return db;
}

4. 排查进程与缓存残留 #

• 确认恢复操作执行时，没有其他线程持有数据库连接
• Android平台可通过adb shell ps查看应用进程状态，必要时强制杀死进程后再执行恢复

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