Android Jetpack DataStore命名为settings时首次启动值非空问题排查

核心原因是Jetpack DataStore的自动迁移机制触发了旧数据导入：

• 当使用name = "settings"创建Preferences DataStore时，DataStore会自动检测应用中是否存在同名的旧SharedPreferences文件（即settings.xml，存储在应用数据目录的shared_prefs下）。如果之前你的应用通过SharedPreferences存储过isPermissionDialogShown这个key的值，DataStore会自动将该文件中的所有数据迁移到新的DataStore中。这就导致首次打开应用时，preferences[showPermissionDialogKey]已经有历史值，不会触发代码中的默认值?: true逻辑，表现为值不为空。
• 当改为name = "my_settings"时，不存在对应的旧SharedPreferences文件，DataStore初始化时没有可迁移的数据，preferences[showPermissionDialogKey]为null，因此会使用默认值true，恢复预期行为。

验证方法 #

• 检查应用的shared_prefs目录下是否存在settings.xml文件，查看其中是否包含isPermissionDialogShown字段；
• 清除应用数据后重新测试使用settings名称的DataStore，此时旧数据被清除，首次打开会使用默认值。

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