Android Jetpack Compose 切换Locale后stringResource不更新问题求助

云上老周

2026-9-27

问题根因

Jetpack Compose的stringResource依赖LocalConfiguration提供的上下文资源，你在应用内手动切换Locale后，只更新了存储的Locale值，没有主动同步更新Compose层绑定的资源配置，所以Composable重组时拉取的还是旧Locale对应的资源包，只有重启App后ApplicationContext重新加载新Locale的资源才会生效。

可行解决方案

第一步：手动更新应用全局的Configuration配置
切换Locale的逻辑中，除了保存你自定义的Locale状态，还要同步更新上下文的资源配置，参考代码：

fun updateAppLocale(targetLocale: Locale, context: Context) {
    Locale.setDefault(targetLocale)
    val resources = context.resources
    val config = resources.configuration
    config.setLocale(targetLocale)
    config.setLayoutDirection(targetLocale)
    context.createConfigurationContext(config)
    resources.updateConfiguration(config, resources.displayMetrics)
}

第二步：配置Activity的配置变更监听
在AndroidManifest.xml中给承载Compose页面的Activity添加configChanges属性，捕获Locale变更事件，避免Activity自动重启：
```
<activity
    android:name=".YourComposeHostActivity"
    android:configChanges="locale|layoutDirection|screenLayout|screenSize|smallestScreenSize" />
```
第三步：适配Activity的配置变更回调
重写宿主Activity的onConfigurationChanged方法，只要触发该回调，Compose会自动同步最新的Configuration到LocalConfiguration，不需要额外写触发重组的逻辑：
```
override fun onConfigurationChanged(newConfig: Configuration) {
    super.onConfigurationChanged(newConfig)
}
```

易遗漏的检查项

不要在非Composable作用域缓存字符串资源，比如把stringResource的返回值存到顶层变量、ViewModel成员变量里，这类缓存不会跟随Locale变更更新，必须在Composable重组时实时调用stringResource加载
确认多语言资源文件符合规范，不同Locale目录下的字符串ID完全对应，没有缺失目标国家的翻译条目
若使用AppCompat 1.6.0及以上版本，要确保自定义的Locale更新逻辑和AppCompat的Locale配置逻辑兼容，不要出现两者存储的Locale不一致的情况

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