详见附件1
export default {
// ...
components: {
// #ifdef APP-HARMONY
upgradePopupVue
// #endif
},
methods: {
checkVersion() {
// #ifdef APP-PLUS
checkUpdate()
// #endif
// #ifdef APP-HARMONY
checkUpdate(this.$refs.upgradePopup)
// #endif
.then((res) => {
console.log('res: ', JSON.stringify(res));
})
.catch((e) => {
console.log('e: ', JSON.stringify(e), e);
});
}
}
// ...
}
- 发布:2026-04-24 17:22
- 更新:2026-04-24 17:23
- 阅读:16
产品分类: uniapp/App
PC开发环境操作系统: Windows
PC开发环境操作系统版本号: 10
HBuilderX类型: 正式
HBuilderX版本号: 5.05
手机系统: HarmonyOS NEXT
手机系统版本号: HarmonyOS 5.0.2
手机厂商: 华为
手机机型: pura70
页面类型: vue
vue版本: vue3
打包方式: 云端
项目创建方式: HBuilderX
App下载地址或H5⽹址: -
示例代码:
操作步骤:
详见附件1
详见附件1
预期结果:
鸿蒙检查热更新checkupdate可正常调用云函数uni-upgrade-center
鸿蒙检查热更新checkupdate可正常调用云函数uni-upgrade-center
实际结果:
提示:{"errMsg":"未匹配到云函数[uni-upgrade-center]","errCode":"NOT_FOUND","code":"NOT_FOUND"} [Error] 未匹配到云函数[uni-upgrade-center]详见附件1,但是云端函数 [uni-upgrade-center]
提示:{"errMsg":"未匹配到云函数[uni-upgrade-center]","errCode":"NOT_FOUND","code":"NOT_FOUND"} [Error] 未匹配到云函数[uni-upgrade-center]详见附件1,但是云端函数 [uni-upgrade-center]
bug描述:
使用Vue3 框架,开发HarmonyNext应用,接入升级中心热更新,app插件从v0.8.1升级为v0.9.9,按照文档https://doc.dcloud.net.cn/uniCloud/upgrade-center.html#uni-upgrade-center-app-harmonyos 热更新调用如下代码:
export default {
// ...
components: {
// #ifdef APP-HARMONY
upgradePopupVue
// #endif
},
methods: {
checkVersion() {
// #ifdef APP-PLUS
checkUpdate()
// #endif
// #ifdef APP-HARMONY
checkUpdate(this.$refs.upgradePopup)
// #endif
.then((res) => {
console.log('res: ', JSON.stringify(res));
})
.catch((e) => {
console.log('e: ', JSON.stringify(e), e);
});
}
}
// ...
}
提示:{"errMsg":"未匹配到云函数[uni-upgrade-center]","errCode":"NOT_FOUND","code":"NOT_FOUND"} [Error] 未匹配到云函数[uni-upgrade-center]详见附件1,但是云端函数 [uni-upgrade-center]正常详见附件2.
Ask小助手 - Ask社区AI助手
未能获取明确的问题分类(uniapp,uni-app x,unicloud,HbuilderX)请明确说明问题采用的技术,补充相关的信息有助于更好的解决问题
欢迎到专业群( uni-app鸿蒙化技术交流群 ) 咨询,群中有相关专业的管理员和群友。
这个 bug 反馈需要补充关键信息才能进一步定位问题,但从现有信息可以给出初步分析和排查建议。
评审结论:反馈信息不完整,需补充复现细节和云函数部署状态
详细分析如下:
1. 内容完整性评估
- 标题与描述:标题明确指出了版本(HBuilderX 5.05)、平台(HarmonyOS Next)和核心错误(未匹配到云函数),描述中提到了升级中心版本从 0.8.1 升级到 0.9.9 的过程,信息基本清晰。
- 代码示例:提供的代码片段仅为前端调用示例(
checkUpdate),缺少关键的云函数部署状态、服务空间关联配置以及uni-admin相关配置信息。官方人员无法仅凭此代码判断云函数是否已正确上传至服务空间。 - 复现步骤:描述为"详见附件1",但附件内容未提供,这是重大缺失。无法判断用户是否已完成以下关键步骤:
- 是否在
uni-admin中正确配置了应用 - 是否已将
uni-upgrade-center云函数上传至服务空间 - 本地调试时是否切换到了"连接云端云函数"模式
- 是否在
- 环境信息:版本信息完整(HBuilderX 5.05、HarmonyOS 5.0.2、Vue3),但缺少
uni-upgrade-center-app插件的具体版本和uni-admin的版本号。
2. Bug 成立性判断
基于知识库信息,这个问题大概率不是插件 Bug,而是本地调试环境配置问题:
根据知识库中关于"未匹配到云函数"的类似案例(uni-stat-receiver 错误):链接
本地调试时,默认连接的是本地云函数(即当前项目下的云函数),而接收上报数据的云函数存在于
uni-admin项目中,不在当前项目下,所以会出现此错误,因此在本地调试时,需要在 HBuilderX 下方控制台选择"连接云端云函数"。
uni-upgrade-center 云函数自 uni-admin 1.9.3+ 起作为内置插件存在,并不在用户的项目本地,因此本地调试时必须连接云端云函数才能调用。
3. 排查建议(请用户确认)
请按以下步骤排查:
-
确认云函数部署状态:登录 uniCloud 控制台,检查服务空间中是否存在
uni-upgrade-center云函数(注意:不是check-version,自 0.6.0 起已废弃)。如不存在,需在uni-admin项目中右键上传部署。 -
检查本地调试模式:在 HBuilderX 底部控制台,确认已选择"连接云端云函数"而非"连接本地云函数"。这是本地调试时最常见的错误原因。
-
确认服务空间关联:确保当前项目已关联包含
uni-upgrade-center云函数的服务空间(即与uni-admin项目关联的同一服务空间)。 -
验证插件版本兼容性:
uni-upgrade-center-appv0.9.9 要求uni-admin版本 >= 1.9.3,请确认后台版本是否匹配。 -
清理缓存重试:删除
unpackage目录,重新运行到鸿蒙设备。
4. 需要补充的信息
为了进一步确认问题,请补充:
uni-admin的版本号- 是否在 HBuilderX 控制台选择了"连接云端云函数"
uniCloud/cloudfunctions目录下是否有uni-upgrade-center云函数文件夹(理论上应该在uni-admin项目中,而非客户端项目)- 完整的错误日志(包括调用时的网络请求详情)
结论:当前反馈的问题大概率是本地调试时未连接云端云函数导致,而非插件 Bug。请按上述步骤排查,如确认已连接云端仍报错,请补充上述信息后重新提交。