0

0

React Native 新架构下 Haste 包模块解析失败问题的解决方案

碧海醫心

碧海醫心

发布时间:2026-01-04 22:58:02

|

892人浏览过

|

来源于php中文网

原创

React Native 新架构下 Haste 包模块解析失败问题的解决方案

该错误源于 react native 0.70 版本中 metro 解析器对 haste 包路径的严格校验机制,导致 turbomodule 的 js 接口文件(如 `nativecalculator.js`)无法被正确识别;升级至 0.71+ 可彻底解决。

在采用 React Native 新架构(New Architecture)开发原生模块(如 TurboModule)时,开发者常遇到如下构建错误:

Error: While resolving module `rtn-calculator/js/NativeCalculator.js`, the Haste package `rtn-calculator` was found. However the module `js/NativeCalculator.js` could not be found within the package.

此错误仅出现在 Android 平台(iOS 不受影响),根本原因在于:React Native v0.70 引入了更严格的 Haste 模块解析逻辑,要求 TurboModule 对应的 JS 接口文件必须位于与原生包名完全匹配的 Haste 包路径下,且 Metro 会主动尝试按 package.json#name 字段查找对应 haste 名称(即 rtn-calculator),但若该目录未被显式注册为 haste root,或文件路径不符合 Metro 的默认解析规则(如缺少 index.js 入口、扩展名不匹配、大小写敏感等),就会触发上述“module not found”报错。

官方已确认并修复:该问题是 v0.70 的已知回归(regression),并在 v0.71 正式版中彻底修复(详见 GitHub Issue #35832)。因此,最直接、最可靠的解决方案是升级 React Native 至 ≥ 0.71.0

# 升级 CLI(如使用)
npx react-native upgrade

# 或手动更新 package.json 后重装
npm install react-native@0.71.0
cd ios && pod install && cd ..
npx react-native run-android

⚠️ 若因项目约束暂无法升级,可临时规避(不推荐长期使用):

LogoAi
LogoAi

利用AI来设计你喜欢的Logo和品牌标志

下载
  • 确保 TurboModule 的 JS 文件(如 NativeCalculator.ts)导出路径与 haste name 严格一致,例如将文件置于 ./rtn-calculator/js/NativeCalculator.ts,且 rtn-calculator/package.json 中 "name": "rtn-calculator";
  • 在 metro.config.js 中显式添加 haste root(需配合 hasteImpl 配置):
    const path = require('path');
    module.exports = {
      resolver: {
        extraNodeModules: {
          'rtn-calculator': path.resolve(__dirname, 'rtn-calculator'),
        },
        // ⚠️ 注意:v0.70 中 haste 支持已弱化,此配置效果有限
      },
    };
  • 将 .ts 文件编译为 .js 并确保存在 .js 后缀版本(Metro 默认不处理 .ts,除非配置 TypeScript transformer)。

? 关键注意事项

  • 新架构项目务必使用 react-native@0.71+ + @react-native-community/cli@10.2+ 组合;
  • JS 接口文件命名建议统一为 Native.ts(如 NativeCalculator.ts),并确保 TurboModuleRegistry.get('RTNCalculator') 中的模块名与 Android CalculatorModule.NAME 和 iOS RCT_EXPORT_MODULE() 注册名完全一致(大小写敏感)
  • 所有 TurboModule 必须继承自 NativeModuleSpec(Android)或 NativeCalculatorSpec(由 Codegen 生成),不可直接继承 ReactContextBaseJavaModule。

总结:该错误本质是 v0.70 的 Metro 解析缺陷,非项目配置错误。强烈建议升级至 v0.71 或更高版本,既可一劳永逸解决问题,又能获得新架构稳定性增强、TypeScript 支持优化及 Codegen 性能提升等关键改进。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

404

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

531

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

308

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

74

2025.09.10

硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

1004

2023.10.19

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

56

2025.10.17

php8.4实现接口限流的教程
php8.4实现接口限流的教程

PHP8.4本身不内置限流功能,需借助Redis(令牌桶)或Swoole(漏桶)实现;文件锁因I/O瓶颈、无跨机共享、秒级精度等缺陷不适用高并发场景。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

303

2025.12.29

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

510

2023.06.20

漫蛙2入口地址合集
漫蛙2入口地址合集

本专题整合了漫蛙2入口汇总,阅读专题下面的文章了解更多详细内容。

162

2026.01.06

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
React 教程
React 教程

共58课时 | 3.4万人学习

国外Web开发全栈课程全集
国外Web开发全栈课程全集

共12课时 | 0.9万人学习

React核心原理新老生命周期精讲
React核心原理新老生命周期精讲

共12课时 | 1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号