Android点击按钮执行Room多表数据插入失败求助

核心问题推测 #

你遇到的问题大概率是两个原因叠加导致的：

• 点击按钮后立刻调用navigateUp()，页面回退导致ViewModel的viewModelScope被取消，未完成的数据库插入协程直接终止。
• 三个插入操作并行执行时，Room的SQLite连接可能出现资源竞争，或者某一个操作抛出了未捕获的异常（比如约束冲突），导致后续操作被中断。

验证步骤 #

先给每个插入操作加上异常捕获，确认是否有报错：
在Repository的插入方法里添加try-catch：

suspend fun insertRoute(route: Route) {
    try {
        dao.insertRoute(route)
    } catch (e: Exception) {
        Log.e("RoomError", "Insert Route failed: ${e.message}")
    }
}

// 另外两个插入方法同理添加异常捕获

查看Logcat，确认是否有约束冲突（比如主键重复）或者其他异常。

解决方案 #

方案1：合并所有操作到一个事务，并确保完成后再导航

Room的事务可以保证多个操作的原子性，同时避免并行操作的资源竞争，而且要等待所有操作完成后再执行页面导航。

1. DAO层添加事务方法
   在DAO中添加一个包含三个插入的事务方法：

@Transaction
suspend fun insertAllData(route: Route, routeNotifications: List<RouteNotification>, systemNotifications: List<SystemNotification>) {
    insertRoute(route)
    insertRouteNotificationList(routeNotifications)
    insertSystemNotificationList(systemNotifications)
}

2. Repository层封装方法

suspend fun insertAllData(route: Route, routeNotifications: List<RouteNotification>, systemNotifications: List<SystemNotification>) {
    dao.insertAllData(route, routeNotifications, systemNotifications)
}

3. ViewModel层添加统一保存方法

fun saveAllData(route: Route, routeNotifications: List<RouteNotification>, systemNotifications: List<SystemNotification>, onComplete: () -> Unit) {
    viewModelScope.launch {
        try {
            repository.insertAllData(route, routeNotifications, systemNotifications)
            onComplete() // 所有操作完成后再执行导航
        } catch (e: Exception) {
            Log.e("RoomError", "Batch insert failed: ${e.message}")
            // 这里可以添加错误处理，比如提示用户保存失败
        }
    }
}

4. 修改按钮点击逻辑

Button(
    // other button properties
    onClick = {
        viewModel.saveAllData(route, routeNotificationList, systemNotificationList) {
            navigateUp.invoke() // 仅在保存完成后回退页面
        }
    }
)

方案2：如果必须分开执行，确保协程完成后再导航

如果不想合并事务，也可以使用async等待所有协程完成：

// ViewModel中的方法
fun saveAllAndNavigate(route: Route, routeNotifications: List<RouteNotification>, systemNotifications: List<SystemNotification>, onComplete: () -> Unit) {
    viewModelScope.launch {
        val job1 = async { repository.insertRoute(route) }
        val job2 = async { repository.insertRouteNotificationList(routeNotifications) }
        val job3 = async { repository.insertSystemNotificationList(systemNotifications) }
        // 等待所有任务完成
        job1.await()
        job2.await()
        job3.await()
        onComplete()
    }
}

然后按钮点击时调用这个方法，在onComplete回调里执行导航。

关键注意点 #

• 永远不要在数据库操作未完成时就执行页面导航，因为viewModelScope会随着页面销毁而取消所有协程，导致操作中断。
• Room的@Transaction注解必须用在suspend函数上，确保所有操作在同一个事务中执行，要么全部成功，要么全部失败。
• 一定要捕获数据库操作的异常，很多时候插入失败是因为约束冲突（比如主键重复），只是你没看到报错。

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