React Native更新后Android端出现TypeError: Cannot read property 'languages' of null

问题背景 #

项目升级后：React从17.0.1→17.0.2，React Native从0.64.4→0.67.4；Android编译配置同步升级（compileSdk/targetSdk从33升至34，buildTools从29.0.3升至34.0.0，Gradle classpath/版本对应升级）。出现现象：yarn android调试运行正常，但debug APK报错、release APK直接崩溃，debug模式错误提示为TypeError: Cannot read property 'languages' of null，iOS端无异常。

可能原因 #

• 原生模块适配不足：React Native 0.67.x对Android 14（API34）的语言获取逻辑有调整，旧的语言获取模块（或第三方i18n类库）在release模式下初始化失败，返回null值。
• ProGuard混淆破坏代码：release模式下ProGuard混淆了与语言获取相关的类/方法，导致运行时无法正确访问languages属性。
• Android API变更影响：Android 14对系统语言获取的API做了更新，旧实现逻辑在release环境下无法正常获取语言数据。

修复方案 #

1. 给代码添加空值防护 #

找到项目中访问languages的代码，强制添加空值判断，避免直接访问null对象的属性：

// 原错误代码示例
const currentLang = localeObject.languages[0];
// 修改后（添加可选链与默认值）
const currentLang = localeObject?.languages?.[0] || 'en-US'; // 替换为项目默认语言

如果是第三方库导致的问题，检查库版本是否适配RN 0.67.4和Android API34，不适配的话优先升级库版本，也可临时fork库代码添加空值判断。

2. 配置ProGuard规则避免混淆 #

在android/app/proguard-rules.pro中添加规则，保留语言相关类不被混淆：

# 保留RN官方I18n模块
-keep class com.facebook.react.modules.i18nmanager.I18nManager { *; }
# 保留系统Locale类
-keep class java.util.Locale { *; }
# 如果使用react-native-localize等第三方i18n库，添加对应保留规则
-keep class com.zoontek.rnlocalize.** { *; }

3. 适配Android API34的语言获取逻辑 #

如果是自定义原生模块获取语言，改用Android 14推荐的API：

// 旧代码（不适配API34）
Locale oldLocale = getResources().getConfiguration().locale;
// 新代码（适配API34）
LocaleList localeList = getResources().getConfiguration().getLocales();
Locale currentLocale = localeList.get(0);

4. 彻底清理缓存后重新构建 #

执行以下命令确保缓存全部清理，再重新打包：

# 重置React Native缓存
npx react-native start --reset-cache
# 清理Android构建缓存并打包release版本
cd android && ./gradlew clean && ./gradlew assembleRelease

额外排查技巧 #

• 开启release模式调试：修改android/app/build.gradle的release配置，让release包可调试，便于查看更详细的崩溃日志：

  buildTypes {
      release {
          debuggable true
          // 其他原有配置保持不变
      }
  }
  

• 逐个排查第三方依赖：临时移除非必要的第三方库，测试是否还会崩溃，快速定位到具体的问题依赖。

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