android 应用运行时语言切换突然失效（始终回退到默认 english），即使代码逻辑正确、资源目录完整、git 历史可验证曾正常工作，常见原因包括构建缓存污染、gradle 配置异常、资源配置冲突及 android 8.0+ 系统限制，需系统性排查并优先清理构建环境。
在 Android 开发中，运行时动态切换应用语言（如从 English 切换为 Dutch/NL）是一个经典但易出问题的功能。你描述的现象——调试版和正式版均无法生效，仅预览界面（Layout Editor）显示正常，且回退历史版本仍无效——表明问题大概率不在业务逻辑本身，而是由构建/运行时环境引发的“静默故障”。
? 根本原因分析（不止于 lintOptions.abortOnError = false）
虽然问题标题提及 lintOptions.abortOnError = false，但该配置仅影响 Lint 检查是否中断构建，并不直接干预资源打包或 Locale 加载流程。真正导致语言切换失效的常见原因如下：
| 类别 | 具体原因 | 是否影响你的项目 |
|---|---|---|
| ✅ 构建缓存污染 | Android Studio 的 Gradle 缓存、Instant Run 缓存、AAPT2 编译中间产物残留，可能导致 values-nl/strings.xml 未被正确打包进 APK，或 resources.arsc 中缺失对应 locale 条目 | ⚠️ 极高概率（你最终通过重装 AS + 重克隆解决，正是此原因） |
| ✅ resConfig / resConfigs 误配置 | 若 build.gradle 中显式声明了 resConfigs ["en"] 或 resConfigs "en"，会强制只保留 English 资源，删除所有 values-nl/、values-fr/ 等目录 | ❌ 你当前 Gradle 中未配置，可排除 |
| ✅ android.useAndroidX=true + android.enableJetifier=true 引发的资源合并异常 | 较老项目升级 AndroidX 后，若 Jetifier 处理失败，可能破坏 values-xx 目录结构 | ⚠️ 需检查 gradle.properties，你未提供该文件，建议确认 |
| ⚠️ Android 7.0+ Configuration.setLocale() 已废弃，8.0+ 必须使用 createConfigurationContext() | 你当前 Java 代码使用 config.locale = ...; res.updateConfiguration(...) 是 API 24 以下兼容写法，在 Android 8.0+（API 26+）设备上将完全失效 | ✅ 关键缺陷！见下方修复代码 |
? 正确的多语言切换实现（适配 Android 8.0+）
你当前的 Java 代码存在严重兼容性问题：
// ❌ 错误：已废弃，Android 8.0+ 完全无效
Locale languageToSwitch = new Locale("nl");
Locale.setDefault(languageToSwitch);
Resources res = getBaseContext().getResources();
DisplayMetrics dm = Resources.getSystem().getDisplayMetrics(); // ⚠️ 错误：应使用 res.getDisplayMetrics()
Configuration config = res.getConfiguration();
config.locale = languageToSwitch; // ⚠️ API 24+ 已废弃
res.updateConfiguration(config, dm); // ⚠️ API 25+ 已废弃
recreate();✅ 推荐方案（兼容 API 16+，推荐 AndroidX）：
// ✅ 正确：使用 createConfigurationContext()（Android 7.0+ 推荐）
public void changeLanguage(Context context, String languageCode) {
Locale locale = new Locale(languageCode);
Locale.setDefault(locale);
Configuration config = new Configuration();
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN_MR1) {
config.setLocale(locale);
} else {
config.locale = locale;
}
Context updatedContext = context.createConfigurationContext(config);
Resources resources = updatedContext.getResources();
// 更新 Application 和 Activity 的资源引用（关键！）
getApplication().getResources().updateConfiguration(config, resources.getDisplayMetrics());
getResources().updateConfiguration(config, resources.getDisplayMetrics());
// 重启 Activity
recreate();
}? 注意：若使用 AppCompatActivity，还需在 onAttach() 或 attachBaseContext() 中提前应用配置（防止 Activity 初始化时读取错误 locale）：@Override protected void attachBaseContext(Context base) { super.attachBaseContext(updateLocale(base)); } private Context updateLocale(Context context) { SharedPreferences prefs = PreferenceManager.getDefaultSharedPreferences(context); String lang = prefs.getString("app_language", "en"); Locale locale = new Locale(lang); Locale.setDefault(locale); if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) { return context.createConfigurationContext( new Configuration().setLocale(locale) ); } else { Configuration config = new Configuration(); config.locale = locale; context.getResources().updateConfiguration(config, context.getResources().getDisplayMetrics()); return context; } }
? 必做环境清理步骤（解决“历史版本也不工作”）
你最终通过「删除项目 + 卸载 Android Studio + 重克隆」解决，本质是清除了以下顽固缓存：
- Gradle 用户级缓存：~/.gradle/caches/
- Android Studio 系统缓存：~/.AndroidStudio*/system/caches/
- 项目级构建产物：./build/, ./app/build/, ./.gradle/
- AAPT2 缓存：~/.gradle/caches/transforms-*/
✅ 高效替代方案（无需重装）：
# 1. 清理项目 ./gradlew clean # 2. 清理 Gradle 缓存（谨慎，首次构建稍慢） rm -rf ~/.gradle/caches/ # 3. Android Studio 内操作：File → Invalidate Caches and Restart → "Invalidate and Restart" # 4. 检查 APK 内资源是否包含 nl： unzip -l app/build/outputs/apk/debug/app-debug.apk | grep "values-nl" # ✅ 应看到 values-nl/strings.xml；❌ 若无，则资源未被打包（检查 res 目录路径、productFlavors 配置）
✅ 最终检查清单
- [ ] src/main/res/values-nl/strings.xml 存在且内容正确
- [ ] build.gradle 中 未配置 resConfigs（你当前符合）
- [ ] android:resource 在 strings.xml 中未拼写错误（如 @string/app_name 存在）
- [ ] 使用 createConfigurationContext() 替代 updateConfiguration()（尤其 Android 8.0+ 设备）
- [ ] 执行 Invalidate Caches and Restart + Clean Project + Rebuild Project
- [ ] 用 apktool 或 Android Studio > Build > Analyze APK 验证 resources.arsc 中含 nl locale
语言切换不是“写完就跑”，而是构建系统、资源机制与运行时 API 的协同结果。当逻辑看似无懈可击却集体失效时，请优先怀疑环境——缓存比代码更擅长隐藏真相。
