在Lifecycle.Event.ON_STOP中保存数据到Preferences DataStore不生效如何解决

问题根因 #

你遇到的写入失败问题确实和协程取消有关。当用户点击返回键销毁宿主Activity时，Activity级别的ViewModel会立即触发onCleared回调，viewModelScope绑定的所有协程会被同步取消，而你在ON_STOP事件中启动的保存协程还没完成DataStore的异步写入操作就被终止，自然无法将数据持久化到本地。

正确实现方案 #

可以根据你的业务场景选择以下三种方案：

方案1：使用Application级全局协程执行保存（推荐，适配绝大多数场景） #

自定义全局协程Scope，绑定App生命周期，不会随页面销毁被取消，确保写入操作执行完成。

1. 先通过Hilt注入全局协程实例：

// 限定符注解
@Retention(AnnotationRetention.BINARY)
@Qualifier
annotation class IoDispatcher

@Retention(AnnotationRetention.BINARY)
@Qualifier
annotation class ApplicationScope

// Hilt模块
@Module
@InstallIn(SingletonComponent::class)
object CoroutineModule {
    @Provides
    @Singleton
    @IoDispatcher
    fun provideIoDispatcher(): CoroutineDispatcher = Dispatchers.IO

    @Provides
    @Singleton
    @ApplicationScope
    fun provideApplicationScope(@IoDispatcher dispatcher: CoroutineDispatcher): CoroutineScope 
        = CoroutineScope(SupervisorJob() + dispatcher)
}

2. 改造ViewModel的保存方法，用全局Scope启动协程：

@HiltViewModel
class MyViewModel @Inject constructor(
    private val repository: Repository,
    @ApplicationScope private val appScope: CoroutineScope
) : ViewModel() {
    // 原有其他逻辑不变
    fun saveDataToPreferences() {
        appScope.launch {
            Log.d(GameApp.TAG, "save data, data=${_myUiState.value}")
            repository.saveData(_myUiState.value)
        }
    }
}

方案2：等待保存完成再退出页面（适合数据量极小的场景） #

修改保存逻辑为同步挂起，在返回拦截中等待写入完成后再销毁页面：

1. 调整ViewModel的保存方法为纯挂起函数：

suspend fun saveDataToPreferences() {
    Log.d(GameApp.TAG, "save data, data=${_myUiState.value}")
    repository.saveData(_myUiState.value)
}

2. 在宿主Activity中重写返回逻辑：

override fun onBackPressed() {
    lifecycleScope.launch {
        myModel.saveDataToPreferences()
        finish()
    }
}

注意：如果写入数据量较大，该方案可能会导致返回时出现短暂卡顿，不建议复杂场景使用。

方案3：通过WorkManager执行保存（适合核心数据、可靠性要求极高的场景） #

如果数据不允许丢失，即使用户退出后App被系统杀死也需要确保写入完成，可以使用WorkManager发起一次性后台任务执行写入操作，系统会保证任务最终执行。

其他注意事项 #

你当前的Fragment代码中，添加生命周期观察者的变量名存在笔误：lifecycle.addObserver(GameFragmentLifecycleObserver(gamePlayViewModel)) 中的gamePlayViewModel应该替换为你实际声明的myModel，避免出现空指针或者逻辑不触发问题。

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