React Native升级后出现new NativeEventEmitter()错误及iOS白屏问题求助

核心问题分析 #

第一个错误Invariant Violation: \new NativeEventEmitter()` requires a non-null argument`是触发后续AppRegistry失败、白屏的根源——某个模块初始化时给NativeEventEmitter传了空值，导致JS初始化流程中断，最终AppRegistry无法正常运行。

解决步骤 #

1. 定位错误来源 #

先找到哪个模块调用NativeEventEmitter时传了null，在项目入口文件（如index.js）最顶部添加以下代码，打印错误调用栈：

import { NativeEventEmitter } from 'react-native';

const OriginalNativeEventEmitter = NativeEventEmitter;
NativeEventEmitter = function (nativeModule) {
  if (!nativeModule) {
    console.error('NativeEventEmitter 接收空模块:', new Error().stack);
  }
  return new OriginalNativeEventEmitter(nativeModule);
};

重新运行项目，查看控制台日志，就能定位到具体出问题的第三方库或自定义模块。

2. 修复模块适配问题 #

• 升级第三方库：如果是第三方库导致的，查看该库版本是否适配React Native 0.70+，直接升级到最新兼容版本。
• 打补丁修复：如果库已停止维护，用patch-package给库添加非空判断。比如找到库中调用new NativeEventEmitter(NativeModules.XXX)的代码，修改为：

  import { NativeModules, NativeEventEmitter } from 'react-native';
  const XXXModule = NativeModules.XXX;
  const emitter = XXXModule ? new NativeEventEmitter(XXXModule) : null;
  

• 确认原生模块链接：RN 0.60+支持自动链接，但升级后可能出现链接异常，iOS端重新执行pod install，Android端同步gradle配置。

3. 清理缓存与重建 #

• 清理RN全局缓存：

  npx react-native start --reset-cache
  

• iOS端彻底重建项目：

  cd ios
  rm -rf Pods Podfile.lock
  pod install
  cd ..
  npx react-native run-ios --clean
  

• 删除iOS模拟器中的应用，重新运行项目。

4. 检查AppRegistry注册 #

确认入口文件中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完全一致。

5. 验证Hermes配置 #

RN 0.70默认启用Hermes，检查ios/Podfile中的配置：

use_react_native!(
  :path => config[:reactNativePath],
  :hermes_enabled => true
)

如果之前手动禁用过Hermes，升级后需确认配置是否正确，避免Hermes加载异常。

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