React Native iOS端报错：NativeEventEmitter参数空+myApp未注册求助

针对new NativeEventEmitter() requires a non-null argument错误 #

• 检查所有使用NativeEventEmitter的第三方库或自定义原生模块：
  • 确认原生模块在iOS端已正确注册，比如Objective-C模块是否通过RCT_EXPORT_MODULE()导出，Swift模块是否实现RCTBridgeModule协议并完成注册。
  • 排查近期新增的依赖库，部分库可能存在iOS兼容性问题，可临时移除该库后重新运行验证。
  • 核对NativeEventEmitter初始化代码，确保传入的模块实例不为空：

    // 错误示例：未获取有效模块就初始化
    const emitter = new NativeEventEmitter();
    // 正确示例：先确认模块存在再初始化
    const MyModule = NativeModules.MyModule;
    if (MyModule) {
      const emitter = new NativeEventEmitter(MyModule);
    }
    

针对"myApp" has not been registered错误 #

• 检查AppDelegate.mm的注册逻辑：
  • 确认RCTRootView初始化时的moduleName参数与package.json中的name字段完全一致（iOS对大小写敏感），示例代码：

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

  • 排查是否存在多个RCTRootView注册的情况，或代码中误修改了moduleName的值。
• 验证index.js的入口注册：
  • 确保入口文件正确注册App组件：

    AppRegistry.registerComponent('myApp', () => App);
    

  • 检查是否有其他文件重复注册了不同名称的组件，导致冲突。

额外排查步骤 #

• 清理iOS构建缓存：
  • 打开Xcode，点击菜单栏Product -> Clean Build Folder（快捷键Cmd+Shift+K），重新构建运行。
  • 删除Xcode的DerivedData目录（路径通常为~/Library/Developer/Xcode/DerivedData），找到对应项目的文件夹删除后重启Xcode。
• 检查Podfile配置：
  • 确认Podfile中project名称设置正确，示例：

    project 'myApp', 'myApp Debug' => :debug, 'myApp Release' => :release
    

  • 执行pod install时确保终端当前目录为iOS文件夹，避免路径错误。
• 检查Hermes配置：
  • 确认iOS端已正确启用Hermes，Podfile中是否有use_react_native!(:hermes_enabled => true)，且Xcode Build Settings中ENABLE_HERMES设为YES。可临时禁用Hermes（改为false）后运行，排查Hermes相关兼容性问题。

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