讲师中心 微信公众号

工具推荐

视频效率加速
Seko
Seko

AI短剧一键生成成片

Laper
Laper

剧本策划到成片协作

立刻MV
立刻MV

低成本歌曲 MV、视频生成

updream

一键生成高质量推广成片

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

胖枫小哥_6423

胖枫小哥_6423

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

|

932人浏览过

|

来源于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:

git-staged-commit-message
git-staged-commit-message

仅从仓库的暂存文件生成 Git 提交消息。当用户要求 Codex 根据暂存更改、缓存差异、Git 索引或已通过 `git add` 添加的文件来编写、起草、创建或建议提交消息时使用;切勿代表用户执行提交操作。

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

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

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

  • 确保 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 性能提升等关键改进。

热门AI工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

函子Zion

一款支持AI搭建、可视化编辑和多端发布的全栈无代码开发平台。

相关专题

更多
TypeScript工程化开发与Vite构建优化实践
TypeScript工程化开发与Vite构建优化实践

本专题面向前端开发者,深入讲解 TypeScript 类型系统与大型项目结构设计方法,并结合 Vite 构建工具优化前端工程化流程。内容包括模块化设计、类型声明管理、代码分割、热更新原理以及构建性能调优。通过完整项目示例,帮助开发者提升代码可维护性与开发效率。

332

2026.02.13

TypeScript全栈项目架构与接口规范设计
TypeScript全栈项目架构与接口规范设计

本专题面向全栈开发者,系统讲解基于 TypeScript 构建前后端统一技术栈的工程化实践。内容涵盖项目分层设计、接口协议规范、类型共享机制、错误码体系设计、接口自动化生成与文档维护方案。通过完整项目示例,帮助开发者构建结构清晰、类型安全、易维护的现代全栈应用架构。

540

2026.02.25

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

411

2026.03.13

TypeScript 全栈开发进阶指南
TypeScript 全栈开发进阶指南

面向有 JavaScript 基础的开发者,深入讲解 TypeScript 的类型系统与全栈开发实践。

326

2026.06.03

TypeScript Node.js 全栈工程化与Monorepo架构实践
TypeScript Node.js 全栈工程化与Monorepo架构实践

本专题围绕 TypeScript 在 Node.js 全栈开发中的工程化实践展开,系统讲解 Monorepo 架构设计、包管理策略、模块复用机制以及服务端与前端统一类型系统的构建方法。通过真实项目案例,帮助开发者提升大型全栈项目的可维护性与协作效率。

738

2026.06.16

json数据格式
json数据格式

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

2295

2023.08.07

json是什么
json是什么

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

3782

2023.08.23

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

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

1256

2023.10.13

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

60

2026.11.06

热门下载

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

精品课程

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

共58课时 | 12.5万人学习

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

共12课时 | 1.4万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn