react-native-permissions报错NativeModule.RNPermissions为null，多端均复现求解决

核心问题分析 #

NativeModule.RNPermissions is null 说明原生模块未正确链接到JS层，不管iOS还是Android出现这个错误，都意味着基础的模块链接/初始化步骤缺失，不是单纯更新Pods就能解决的。

分步解决方案 #

1. 确认版本兼容性 #

• 检查package.json中react-native-permissions的版本与你的React Native版本是否匹配：
  • RN 0.60+ 需使用react-native-permissions 3.x及以上版本
  • 若RN版本低于0.60，需使用2.x版本
• 版本不匹配会直接导致链接失败，建议升级到对应兼容的最新稳定版。

2. iOS端完整配置 #

你当前只配置了Camera权限的Pod，但还需确保主模块正确链接：

• 确认Podfile中路径正确：../node_modules/react-native-permissions/ios 这个路径是否真实存在（检查node_modules里的库结构）
• 执行彻底的Pods清理与重装：

  cd ios
  pod deintegrate
  rm -rf Podfile.lock
  pod install
  

• 打开Xcode，检查Build Phases > Link Binary With Libraries中是否存在libRNPermissions.a和libPermission-Camera.a，若缺失手动添加
• 别忘了在Info.plist中添加相机权限描述（后续权限申请会用到）：

  <key>NSCameraUsageDescription</key>
  <string>需要访问相机进行拍照/扫码</string>
  

3. Android端配置（你Android也报错，必须完成这步） #

• 在AndroidManifest.xml中添加相机权限：

  <uses-permission android:name="android.permission.CAMERA" />
  

• 若自动链接失败，手动注册模块：
  打开MainApplication.java，在getPackages()方法中添加：

  import com.reactnativecommunity.permissions.RNPermissionsPackage;
  
  // ...
  
  @Override
  protected List<ReactPackage> getPackages() {
    @SuppressWarnings("UnnecessaryLocalVariable")
    List<ReactPackage> packages = new PackageList(this).getPackages();
    packages.add(new RNPermissionsPackage()); // 添加这行
    return packages;
  }
  

• 清理Android构建缓存并重建：

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

4. 通用缓存清理步骤 #

• 清理Metro缓存，避免JS层缓存导致的模块加载异常：

  npx react-native start --reset-cache
  

• 彻底重装依赖：

  rm -rf node_modules package-lock.json yarn.lock
  npm install # 或 yarn install
  

验证 #

完成上述步骤后，重新启动项目，若仍报错，检查Xcode和Android Studio的构建日志，看是否有具体的链接错误（比如缺失依赖、符号冲突等）。

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