Android SharedPreferences 保存语言配置后硬复位未生效问题

问题原因 #

• 默认值读取受当前Locale影响：restoreLocaleDefaults方法中使用当前应用上下文读取R.string.locale_default，如果此时应用已切换为西班牙语，且该字符串资源有对应的西语翻译，或读取时受当前Locale影响拿到了错误值，最终写入SharedPreferences的默认值实际为西班牙语的Locale标识，重启后自然不会切回英文。Debug模式下单步执行的等待过程可能触发了应用Locale更新，读取到了正确的英文默认值，因此表现正常。
• Locale匹配逻辑不稳定：getLocaleByName方法使用getDisplayName()进行匹配，而该方法返回的是跟随当前系统Locale本地化的显示名，比如英文Locale在西语环境下的显示名为inglés (Estados Unidos)，如果你传入的匹配值是英文的English会直接匹配失败返回null，而setLocale方法对null值不做任何处理，会直接保留当前的西班牙语配置。
• 硬复位时机早于数据落盘：虽然commit()是同步写入方法，但返回成功仅代表数据写入了系统页缓存，不等同于已经写入物理存储。无断点运行时如果在缓存刷入磁盘前就执行硬断电复位，写入的默认值会丢失，设备读取到的还是之前的西班牙语配置。Debug模式下单步等待时间长，缓存有足够时间刷入磁盘，因此配置可以正常生效。

解决方案 #

• 固定默认Locale值，规避本地化影响：不要将默认Locale配置放在strings.xml中，直接定义为常量使用，比如public static final String DEFAULT_LOCALE_CODE = "en_US"，从根源避免读取到本地化的错误值。如果必须用资源存储，需要使用未受当前Locale影响的上下文读取资源，示例代码如下：

// 创建使用默认配置的上下文读取资源
Configuration config = new Configuration(Application.getAppContext().getResources().getConfiguration());
config.setLocale(Locale.ROOT);
Context defaultContext = Application.getAppContext().createConfigurationContext(config);
String defaultLocale = defaultContext.getString(R.string.locale_default);

• 重构Locale匹配逻辑：取消使用本地化的getDisplayName()做匹配，改用Locale的标准编码（如en_US、es_ES）进行精确匹配，匹配逻辑不会随系统语言变化：

public Locale getLocaleByName(String code){
    for(Locale entry : supported_languages){
        if(entry.toString().equals(code)) {
            return entry;
        }
    }
    // 匹配失败返回默认Locale，避免返回null
    return getDeviceDefaultLocale();
}

同时修改supported_languages的初始化逻辑，同样用language code匹配，避免初始化时就加入错误的Locale。

• 优化复位时机确保数据落盘：commit()执行完成后增加1~2秒的延时再执行硬复位，确保系统页缓存完全刷入物理存储。也可以在写入完成后主动读取一次SharedPreferences的值做校验，确认写入成功后再触发复位。
• 恢复默认时主动更新当前Locale：在restoreLocaleDefaults写入配置完成后，主动调用setLocale(getDeviceDefaultLocale())更新当前应用的配置，确保后续操作的Locale状态正确。

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