导入react-native-fs的RNFS后出现NativeEventEmitter等报错求助

错误1：Invariant Violation: new NativeEventEmitter() requires a non-null argument. #

该错误源于react-native-fs的原生模块未正确链接，导致NativeEventEmitter无法找到对应的原生实例。

解决步骤：

• React Native < 0.60版本：重新手动链接模块

  react-native link react-native-fs
  

• React Native >= 0.60版本：
  • iOS：进入项目ios目录，执行依赖安装后重新编译

    cd ios && pod install && cd ..
    

  • Android：
    1. 检查android/settings.gradle是否包含以下配置，缺失则添加：

       include ':react-native-fs'
       project(':react-native-fs').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-fs/android')
       

    2. 确认android/app/build.gradle的dependencies中存在：

       implementation project(':react-native-fs')
       

    3. 检查MainApplication.java是否已注册RNFS包，未注册则手动添加：

       import com.rnfs.RNFSPackage;
       
       @Override
       protected List<ReactPackage> getPackages() {
         return Arrays.asList(
             new MainReactPackage(),
             new RNFSPackage()
         );
       }
       

• 清除Metro缓存并重启服务：

  npx react-native start --reset-cache
  

错误2：Invariant Violation: "ProjectName" has not been registered. #

此错误多为RNFS加载失败引发的连锁问题，也可能是Metro运行目录错误导致。

解决步骤：

• 确认Metro在项目根目录运行：停止当前Metro进程，回到项目根目录重新启动

  npx react-native start
  

• 检查项目入口文件（如index.js）是否正确执行App注册：

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

• 完全重启项目：关闭设备上的APP，重新执行编译命令

  # Android
  npx react-native run-android
  # iOS
  npx react-native run-ios
  

总结 #

优先修复react-native-fs的原生模块链接问题，清除缓存重启Metro，再验证项目注册逻辑，即可解决这两个连锁报错。

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