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

React Native新手求助:打包失败报错error: bundling failed: ReferenceError: Module not registered in graph

解决React Native的"Module not registered in graph"打包错误

Hey there! As someone who’s wrestled with this exact error when starting out with React Native, I’ve got a few tried-and-true fixes to share with you:

  • 清除Metro缓存:这是最常见的突破口,Metro的缓存经常会莫名其妙地导致模块注册异常。直接在终端运行:

    npx react-native start --reset-cache
    

    要是你用的是Expo开发环境,就换成这个命令:

    expo start -c
    
  • 仔细检查模块导入路径:很多时候都是路径写错了!比如大小写不匹配(React Native在macOS/Linux上对路径大小写敏感),或者相对路径的层级搞错了(比如多写了一层../或者少写了)。翻一遍你最近新增的导入语句,确认import MyComponent from '../components/MyComponent'这类路径完全正确。

  • 重新安装依赖包:如果缓存清理没用,大概率是依赖安装过程中出了问题。先删掉旧的依赖文件和锁文件,再重新安装:

    rm -rf node_modules package-lock.json yarn.lock
    npm install
    # 用yarn的话就执行下面这句
    yarn install
    
  • 检查Metro配置文件:如果你的项目自定义了metro.config.js,可能是配置里漏掉了某些文件类型或者路径规则。确保resolver部分包含了你项目中使用的所有文件扩展名,比如:

    module.exports = {
      resolver: {
        sourceExts: ['js', 'jsx', 'json', 'ts', 'tsx'], // 根据你的项目需求调整
      },
    };
    
  • 重启所有相关服务和设备:别小看这个操作!有时候就是简单的重启就能解决奇怪的缓存残留问题——关掉Metro开发服务器,关掉模拟器或者断开真机连接,然后重新启动项目:

    npx react-native run-android
    # iOS项目就用这个命令
    npx react-native run-ios
    

如果以上方法都没搞定,建议检查一下你最近引入的第三方库,有些库可能需要额外的原生链接步骤,或者版本和你的React Native版本不兼容,这时候可以尝试降级或升级对应库的版本。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.05.11 08:40:06