You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

React Native报错:模块加载失败且未调用AppRegistry.registerComponent求解决

React Native "AppRegistry.registerComponent wasn't called" 报错解决建议

针对你遇到的A module failed to load due to an error and AppRegistry.registerComponent wasn't called., js engine: hermes报错,结合你的代码(index.js和app.json本身无明显问题),可以按以下步骤排查:

  • 检查App.js文件是否存在问题
    报错核心是模块加载失败,大概率是./App这个模块有语法错误、导入错误或依赖缺失。你可以先把App.js替换为极简测试代码验证:

    import React from 'react';
    import { View, Text } from 'react-native';
    
    const App = () => {
      return (
        <View style={{ flex: 1, justifyContent: 'center', alignItems: 'center' }}>
          <Text>测试页面</Text>
        </View>
      );
    };
    
    export default App;
    

    替换后重新运行项目,若报错消失,说明原App.js存在问题,逐行排查其中的语法、导入或组件逻辑。

  • 清除缓存并重启服务
    缓存冲突是常见诱因,执行以下操作:

    1. 关闭当前运行的Metro服务
    2. 执行缓存重置命令:npx react-native start --reset-cache
    3. 若为iOS项目,额外执行:cd ios && pod deintegrate && pod install && cd ..
    4. 重新启动项目
  • 确认依赖已正确安装
    执行npm install或yarn install(根据你使用的包管理器),确保所有package.json中的依赖都已完整安装,没有缺失或版本不兼容的情况。

  • 排查Hermes引擎配置(可选)
    若你手动修改过Hermes相关配置,可能存在配置错误:

    • Android:打开android/app/build.gradle,将enableHermes设为false,重新编译项目
    • iOS:打开ios/Podfile,将use_react_native!(:hermes_enabled => false),执行pod install后重新编译
      若禁用Hermes后报错消失,说明Hermes配置存在问题,可重新检查配置或更新React Native版本。

内容的提问来源于stack exchange,提问作者JhiNResH

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.05 07:32:42