如题，我尝试使用时报异常：uni.[对应api的name] is not a function
我使用的是 uni.requestMerchantTransfer, cli 项目目录如下：
build 后，在 hbx 导入 dist/build/app 目录，这个时候 uni_modules 目录下没有 uni-requestMerchantTransfer，如下图所示：
后续步骤：云端制作自定义基座，然后在基座上调试，日志输出：uni.requestMerchantTransfer is not a function，是不是 cli 项目的使用方式不一样呢？？
欢迎到专业群（ uni-app 官方技术交流群 1 ） 咨询，群中有相关专业的管理员和群友。
好的，我们来分析一下你在 Vue3 + TypeScript 的 uni-app 项目中使用 uni ext api 时遇到 uni-[对应api的name] not found 异常的问题。
根据你的问题描述和知识库中的内容，这个报错通常指向两个核心原因：API 的引入方式不正确，或者运行环境没有包含该 API。
uni ext api 是一类特殊的 API，它们虽然仍以 uni. 开头调用，但已经被剥离为独立的 uni_modules 插件，不再跟随 HBuilderX 或 uni-app 的内核一起发布。这导致它们的使用方式和内置 API 有本质区别。
1. 必须像使用普通插件一样，从插件市场下载并配置到项目中
uni ext api 不能直接像 uni.getSystemInfo() 这样调用。你必须先从 DCloud 插件市场将该 API 对应的 uni_modules 插件安装到你的项目中。
例如，如果你想使用 uni.getBatteryInfo (获取设备电量)，你需要找到对应的 uni-getBatteryInfo 插件，并将其导入到你的 uni_modules 目录下。知识库明确指出：“不常用的API剥离为uni_modules插件，但仍使用uni.开头的API”。
2. 确认 package.json 中的注册声明已正确配置
这是最关键的一步。uni ext api 需要在插件的 package.json 文件中编写注册声明，才能将方法挂载到 uni 对象上。知识库原文强调：“在入口文件export的API，必须在package.json中编写注册声明”。
当你从插件市场导入 ext api 插件后，请检查其 package.json 文件，确保其中包含了正确的注册声明。这个声明通常由插件作者编写，如果你是自己开发或修改了插件，需要自行添加。缺少这个声明是导致 not found 错误的常见原因。
3. 注意 UTS 插件的运行限制
如果这个 ext api 是用 UTS 实现的，你需要特别注意以下几点（均来自知识库）：
@dcloudio 相关的依赖版本完全一致，否则可能出现编译失败。你可以参照知识库中提供的版本检查和修复方法。 ext api，例如你要找的是电量 API，就搜索 uni-getBatteryInfo。 uni_modules 插件导入到你的项目。 package.json 文件，确认其中是否包含了将 API 注册到 uni 对象的声明。如果是官方提供的插件，这一步通常已经完成。 package.json 中 @dcloudio/uni-uts-v1 的版本是否与其他 @dcloudio/ 依赖（如 @dcloudio/uni-app）的版本号完全一致。不一致会导致编译失败。 总的来说，uni-[api的name] not found 这个错误，核心就是 uni-app 运行时在 uni 对象上找不到你调用的方法，根本原因是该 ext api 插件没有被正确安装或注册。按照上述步骤排查，问题应该就能解决。
踩坑大师 - 一直踩坑一直崩溃
解决了吗， 我也遇到了同种问题
回复 Dodu: 难搞啊，我还在尝试， 10:21:06.060 request authorization failed:, Error: undefined class: UTSSDKModulesUniRequestMerchantTransferIndexSwift, uni-requestMerchantTransfer 插件不存在或者编译错误，请检查插件代码是否存在错误，MAC端请配置Xcode环境后重新真机运行或者重新打自定义基座，Windows端请重新打自定义基座。 at pages/reindeerHerder/index.vue:212
10:37:51.027 正在同步文件...
2026-06-17 13:23
Dodu (作者)
回复 j***@udeer.ai: 真的难搞，cli的项目，各种方法我都试过，无果。我在考虑其他解决方案，转账确认收款放在小程序端来实现，或者新建 hbx 项目，重建架构
2026-06-17 15:22
DCloud 即数字天堂(北京)网络技术有限公司是W3C成员及HTML5中国产业联盟发起单位
京ICP备12046007号-4 | 京公网安备：11010802035340号 | 国家信息安全等级保护三级，证书编号：11010813802-20001
