非Expo环境下Native module/AppRegistry报错的其他解决方案求助

报错翻译 #

错误：不变违规：原生模块不能为空。
错误：不变违规：模块AppRegistry不是已注册的可调用模块（调用runApplication）。常见原因是应用入口文件路径不正确。

可行解决方案 #

• 校验入口文件注册逻辑
  确认项目入口文件（通常是index.js）中正确完成AppRegistry注册，示例代码：

  import { AppRegistry } from 'react-native';
  import App from './App';
  import { name as appName } from './app.json';
  
  AppRegistry.registerComponent(appName, () => App);
  

  同步检查app.json内的name字段，确保与注册时的appName完全一致，避免打包工具无法识别入口路径。

• 手动验证原生模块链接状态
  非Expo项目需手动确认第三方原生模块是否正确链接：

  • iOS端：打开ios/[项目名].xcworkspace，检查第三方模块的.xcodeproj是否已添加到Libraries目录，且Build Phases的Link Binary With Libraries列表中包含对应模块的.a文件。
  • Android端：
    1. 检查android/settings.gradle是否添加模块引用：

       include ':react-native-[模块名]'
       project(':react-native-[模块名]').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-[模块名]/android')
       

    2. 确认android/app/build.gradle的dependencies块包含模块依赖：

       implementation project(':react-native-[模块名]')
       

    3. 检查MainApplication.java中是否正确导入并注册模块的Package类。

• 检查Metro配置文件
  确认metro.config.js配置无错误，比如resolver部分是否正确覆盖所需文件扩展名与路径，避免Metro解析模块失败。基础配置示例：

  const { getDefaultConfig, mergeConfig } = require('@react-native/metro-config');
  
  const config = {};
  
  module.exports = mergeConfig(getDefaultConfig(__dirname), config);
  

  若有自定义路径映射，需确保规则正确无冲突。

• 核对原生项目核心配置

  • iOS：检查Info.plist中的CFBundleDisplayName、CFBundleIdentifier是否与app.json配置匹配；确认Build Settings内Product Bundle Identifier设置正确。
  • Android：检查android/app/src/main/AndroidManifest.xml的package属性是否与app.json的android.package一致，同时确认MainActivity.java的包名完全匹配。

• 重启服务与设备
  停止当前Metro服务，关闭模拟器或断开物理设备，执行npx react-native start --reset-cache重置Metro缓存（非重装依赖），之后重新运行npx react-native run-android或npx react-native run-ios。

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