Room数据库数据时而消失重启后恢复的问题排查求助

问题背景 #

部分用户反馈应用中本地Room数据库的数据偶尔会消失，但重启应用后数据又会自动恢复，已收集到用户提供的现象视频，怀疑存在多数据库实例或数据一致性问题，以下是针对代码的排查分析和修复建议：

代码排查分析 #

1. 数据库单例实现（LocalTripsRoomDatabase） #

当前单例采用双重校验锁模式，配合@Volatile修饰INSTANCE，本身逻辑符合单例要求，结合Hilt的@Singleton注解，理论上不会出现多实例问题。但存在一个关键风险点：

• setJournalMode(JournalMode.TRUNCATE)：TRUNCATE日志模式会在事务提交后立即删除日志文件，若应用出现异常导致事务未正常提交，可能导致内存缓存中的数据未同步到磁盘，此时查询会显示数据消失；而重启应用时Room会重新读取磁盘上的完整数据，因此出现“重启恢复”的现象。

2. Repository的协程使用缺陷 #

Repository中所有写入操作（addTrip/updateTrip等）均使用临时CoroutineScope(ioDispatcher)启动协程：

override fun addTrip(tripData: TripData) {
    CoroutineScope(ioDispatcher).launch {
        tripsDao.addTrip(tripData)
    }
}

临时Scope没有绑定任何生命周期，若Scope被意外取消（如系统资源回收、进程短暂后台），会导致DAO写入操作中断，数据仅存在于内存缓存或未完成持久化，进而出现查询不到数据的情况；重启后Room重新加载磁盘数据，数据又显示出来。

3. 其他潜在风险 #

• fallbackToDestructiveMigration()：虽然配置了破坏性迁移兜底，但如果出现意外的版本号变动（如测试包与正式包版本冲突），可能触发数据库重建，但该场景不符合“偶发消失后恢复”的现象，优先级较低。
• Flow订阅的一致性：DAO返回的Flow依赖Room的数据库变更通知，若写入操作未正常完成，Flow可能无法收到更新，导致UI显示数据缺失，但磁盘数据实际存在。

修复建议 #

1. 替换临时协程Scope为稳定Scope #

不要使用临时创建的CoroutineScope，改为注入应用级Scope或让调用方传入可控Scope（如ViewModel的viewModelScope），确保写入操作能完整执行：

// 注入应用级Scope的示例
class LocalTripsRepositoryImpl @Inject constructor(
    @IoDispatcher private val ioDispatcher: CoroutineDispatcher,
    @ApplicationScope private val applicationScope: CoroutineScope,
    private val tripsDao: TripsDao
) : LocalTripsRepository {
    override fun addTrip(tripData: TripData) {
        applicationScope.launch(ioDispatcher) {
            tripsDao.addTrip(tripData)
        }
    }
    // 其他写入方法同理替换
}

更优方案是将写入方法改为suspend，由调用方在合适的Scope中执行，提升可控性：

override suspend fun addTrip(tripData: TripData) {
    tripsDao.addTrip(tripData)
}

2. 恢复Room默认的WAL日志模式 #

移除setJournalMode(JournalMode.TRUNCATE)，使用Room默认的**WAL（Write-Ahead Logging）**模式，该模式支持事务原子性，崩溃后可自动恢复未提交的事务，大幅降低数据不一致的概率：

val instance = Room.databaseBuilder(
    context = context.applicationContext,
    LocalTripsRoomDatabase::class.java,
    DATABASE_NAME
)
// 移除TRUNCATE模式配置，使用默认WAL
.fallbackToDestructiveMigration()
.setQueryCallback({ sqlQuery, bindArgs ->
    Log.d("LocalTripsRoomDatabase", "Query: $sqlQuery - Args: $bindArgs")
}, Dispatchers.IO.asExecutor())
.build()

3. 强化异常捕获与日志记录 #

在所有DAO操作中增加异常捕获，记录详细日志，方便定位偶发的写入失败问题：

override fun addTrip(tripData: TripData) {
    applicationScope.launch(ioDispatcher) {
        try {
            tripsDao.addTrip(tripData)
            Log.d("LocalTripsRepo", "Trip added: ${tripData.tripId}")
        } catch (e: Exception) {
            Log.e("LocalTripsRepo", "Failed to add trip ${tripData.tripId}", e)
        }
    }
}

4. 确认单例唯一性 #

确保所有获取数据库实例的路径均通过LocalTripsRoomDatabase.getInstance()，禁止直接调用Room.databaseBuilder创建实例；同时验证Hilt的DatabaseModule中provideDatabase和provideTripsDao均标注@Singleton，确保全局唯一实例。

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