React Native从0.68升级到0.70后iOS启动卡在闪屏页报错

核心问题定位 #

第一个错误Invariant Violation: new NativeEventEmitter() requires a non-null argument是触发后续AppRegistry异常的根源——某个第三方库或自定义原生模块在初始化NativeEventEmitter时传入了空的原生模块实例，导致JS初始化流程中断，最终AppRegistry无法完成应用注册。

排查与修复步骤 #

1. 定位违规的NativeEventEmitter调用 #

• 全局搜索项目中所有new NativeEventEmitter代码，检查传入的模块是否为null或未正确注册。
• 重点排查第三方依赖库：React Native 0.70对原生模块注册逻辑有调整，部分旧版本库适配性差。可通过临时注释第三方库的初始化代码，逐一排查触发问题的库。
• 典型错误示例：

  import { NativeEventEmitter, NativeModules } from 'react-native';
  // 模块未找到/未注册，导致BadModule为null
  const BadModule = NativeModules.BadModule;
  const emitter = new NativeEventEmitter(BadModule); // 触发错误
  

2. 适配React Native 0.70的原生模块规则 #

React Native 0.70默认启用New Architecture相关模块注册逻辑，旧模块需适配：

• 自定义原生模块：
  确保iOS端模块通过RCT_EXPORT_MODULE()宏注册，且遵循RCTBridgeModule协议要求。
• 第三方库：
  升级该库至支持React Native 0.70的版本；若库未更新，可手动修改其原生代码适配新规则，或暂时替换为替代库。

3. 检查AppDelegate.mm配置 #

确认iOS入口文件的初始化逻辑符合0.70要求：

• 确保RCTRootView初始化时的moduleName与项目名称一致：

  RCTRootView *rootView = [[RCTRootView alloc] initWithBridge:bridge
                                                   moduleName:@"Singlife"
                                            initialProperties:nil];
  

• 若未启用New Architecture，确保相关配置已关闭，避免冲突。

4. 彻底清理iOS构建缓存 #

如果上述步骤无效，执行以下操作重置构建环境：

• 删除ios/Pods目录和Podfile.lock文件
• 执行pod install --repo-update
• 删除Xcode的Derived Data（路径：Xcode → 设置 → 位置 → Derived Data，打开文件夹后删除对应项目的缓存）
• 重新用Xcode编译或执行npx react-native run-ios

5. 验证JS bundle完整性 #

• 手动生成iOS bundle，检查是否存在编译错误：

  npx react-native bundle --platform ios --dev false --entry-file index.js --bundle-output ios/main.jsbundle --assets-dest ios/assets
  

• 确保Xcode项目中已正确引用生成的main.jsbundle和资源文件。

额外提示 #

Android正常运行说明JS逻辑本身无问题，问题集中在iOS端的原生模块注册或依赖适配，优先排查NativeEventEmitter的调用场景是最高效的解决路径。

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