React Native线上App崩溃：NativeModule.RNPermissions为null求助

核心问题分析 #

线上部分Android设备调用checkNotifications()时触发崩溃，根源是JS端无法找到RNPermissions原生模块，常见于原生集成遗漏、打包优化误删模块或初始化时机不匹配。

分步解决方案 #

1. 验证原生模块集成与打包配置 #

• 检查Android模块注册：打开MainApplication.java，确认RNPermissionsPackage已添加到getPackages()方法中：

  import com.zoontek.rnpermissions.RNPermissionsPackage;
  
  @Override
  protected List<ReactPackage> getPackages() {
    return Arrays.asList(
      new MainReactPackage(),
      new RNPermissionsPackage() // 确保这行存在
    );
  }
  

• 清理构建缓存：执行以下命令清理Android构建缓存并重新编译：

  cd android && ./gradlew clean && cd .. && npx react-native run-android
  

• 配置ProGuard/R8规则：如果开启了代码混淆，在proguard-rules.pro中添加保护规则，避免RNPermissions模块被误删：

  -keep class com.zoontek.rnpermissions.RNPermissionsModule { *; }
  -keep class com.zoontek.rnpermissions.RNPermissionsPackage { *; }
  

2. 优化JS端调用逻辑，避免提前触发 #

• 添加模块存在性校验：调用权限检查前先判断原生模块是否加载完成，避免空指针崩溃：

  import { NativeModules } from 'react-native';
  import { checkNotifications, check, PERMISSIONS, Platform } from 'react-native-permissions';
  
  if (NativeModules.RNPermissions) {
    checkNotifications()
      .then(({ status }) => {
        check(Platform.OS === 'ios' ? PERMISSIONS.IOS.CAMERA : PERMISSIONS.ANDROID.CAMERA)
          .then(result => { /* 业务逻辑 */ })
          .catch(() => { /* 异常处理 */ });
      })
      .catch(() => { /* 模块异常降级 */ });
  } else {
    // 模块未加载时的降级处理：比如默认权限为未授权、提示用户重启App
    console.warn('权限模块初始化失败，将使用默认权限配置');
  }
  

• 延迟权限检查时机：避免在App启动初期（如SplashScreen阶段）调用权限接口，可通过AppState监听App进入活跃状态后再执行：

  import { AppState } from 'react-native';
  
  AppState.addEventListener('change', (nextAppState) => {
    if (nextAppState === 'active') {
      // 执行权限检查逻辑
    }
  });
  

3. 排查版本兼容与依赖冲突 #

• 升级react-native-permissions：当前使用的3.6.1版本较旧，可尝试升级到最新稳定版（需同步更新Android/iOS权限配置），新版本通常修复了更多原生兼容问题。
• 检查RN版本匹配：确认当前React Native版本与react-native-permissions 3.6.1兼容（3.6.1适配RN 0.60+，若RN版本过高可能存在兼容性问题）。
• 排查依赖冲突：检查是否有其他权限管理类库（如react-native-image-picker等）修改了NativeModule注册逻辑，导致RNPermissions被覆盖或未加载。

4. 优化Hermes打包配置 #

• 若使用Hermes引擎，检查metro配置是否误排除了RNPermissions：确保metro.config.js中没有相关排除规则。
• 尝试重新生成Hermes字节码：执行npx react-native clean后重新打包。

临时应急修复 #

在现有代码的catch块中添加兜底处理，避免未捕获异常导致崩溃：

checkNotifications()
  .then(({ status }) => {
    // 原有业务逻辑
  })
  .catch((error) => {
    console.warn('权限检查失败:', error);
    // 此处可添加用户提示或默认权限状态赋值
  });

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