Android多Activity操作DataStore报错：多实例冲突求助

报错的核心原因是：DataStore 强制要求同一个存储文件只能对应一个活跃的实例。你的操作流程中，SettingsActivity 和 MainActivity 分别创建了独立的 DataStoreManager 实例，每个实例都初始化了自己的 DataStore 对象，最终导致同一文件关联多个实例，触发 IllegalStateException。

方案1：将 DataStoreManager 实现为全局单例 #

修改 DataStoreManager，确保整个应用中只有一个实例：

class DataStoreManager private constructor(context: Context) {
    private val dataStore = context.createDataStore(name = "settings_prefs")

    // 示例存储方法
    suspend fun saveValue(key: Preferences.Key<String>, value: String) {
        dataStore.edit { it[key] = value }
    }

    // 示例读取方法
    fun getValueFlow(key: Preferences.Key<String>, defaultValue: String): Flow<String> {
        return dataStore.data.map { it[key] ?: defaultValue }
    }

    companion object {
        @Volatile
        private var INSTANCE: DataStoreManager? = null

        fun getInstance(context: Context): DataStoreManager {
            return INSTANCE ?: synchronized(this) {
                val instance = DataStoreManager(context.applicationContext)
                INSTANCE = instance
                instance
            }
        }
    }
}

之后在两个Activity中统一通过单例获取实例：

• SettingsActivity调用示例：

val dataStoreManager = DataStoreManager.getInstance(applicationContext)
lifecycleScope.launch {
    dataStoreManager.saveValue(...)
}

• MainActivity调用示例：

val dataStoreManager = DataStoreManager.getInstance(applicationContext)
lifecycleScope.launch {
    dataStoreManager.getValueFlow(...).collect { value ->
        // 处理读取到的数据
    }
}

方案2：使用依赖注入框架（如Hilt）管理实例 #

如果项目使用Hilt，可以让框架全局管理DataStoreManager的单例：

1. 给DataStoreManager添加单例注解：

@Singleton
class DataStoreManager @Inject constructor(@ApplicationContext context: Context) {
    private val dataStore = context.createDataStore(name = "settings_prefs")

    // 存储/读取方法...
}

2. 在Activity中注入实例：

@AndroidEntryPoint
class SettingsActivity : AppCompatActivity() {
    @Inject lateinit var dataStoreManager: DataStoreManager

    // 使用实例进行数据操作...
}

• 必须使用Application Context初始化DataStore，避免Activity Context引发内存泄漏，同时保证实例生命周期与应用一致。
• 所有操作DataStore的页面，必须复用同一个DataStoreManager实例，禁止多次初始化。

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