cli构建hello-uniapp工程生成鸿蒙元服务：D:\HBuilderX.5.22.2026072503-alpha\HBuilderX\cli.exe launch mp-harmony --project d:\code2026\uniapp\uni-template-news_3.1.8 --deviceId 3DK0124528000470
c***@tmp.dcloud.io
- 发布：2026-07-28 19:47
- 更新：2026-07-28 19:55
- 阅读：34
【报Bug】执行HBuilder 5.15版本或者5.22 alpha版本在cmd中执行cli指令构建uniapp示例工程的鸿蒙元服务，卡住，使用HBuilder 5.07版本没有问题
分类：鸿蒙Next
产品分类： uniapp/App
PC开发环境操作系统： Windows
PC开发环境操作系统版本号： win10
HBuilderX类型： 正式
HBuilderX版本号： 5.22
手机系统： HarmonyOS NEXT
手机系统版本号： HarmonyOS 6.0.0
手机厂商： 华为
手机机型： 鸿蒙6.0手机
页面类型： vue
vue版本： vue3
打包方式： 云端
项目创建方式： HBuilderX
操作步骤：
预期结果：
HBuilder 5.15版本或者5.22 alpha版本，cli可以正常构建鸿蒙元服务
HBuilder 5.15版本或者5.22 alpha版本，cli可以正常构建鸿蒙元服务
实际结果：
执行HBuilder 5.15版本或者5.22 alpha版本在cmd中执行cli指令构建uniapp示例工程的鸿蒙元服务，卡住。
执行HBuilder 5.15版本或者5.22 alpha版本在cmd中执行cli指令构建uniapp示例工程的鸿蒙元服务，卡住。
bug描述：
执行HBuilder 5.15版本或者5.22 alpha版本在cmd中执行cli指令构建uniapp示例工程的鸿蒙元服务，卡住，使用HBuilder 5.07版本没有问题。
- deviceId不传递@AS报错未检测到指定设备
构建指令：D:\HBuilderX.5.22.2026072503-alpha\HBuilderX\cli.exe launch mp-harmony --project d:\code2026\uniapp\uni-template-news_3.1.8 --deviceId 3DK0124528000470
报错信息：
19:33:48.398 HBuilderX Version: 5.22.2026072503-alpha
19:33:48.651 未检测到指定设备 3DK0124528000470
19:33:48.652 当前可用设备：
19:33:48.653 HUAWEI Mate 70 Pro【AS@3DK0124528000470】 1
- deviceId加上@AS，卡住在显示版本号这边，不会执行构建
构建指令：D:\HBuilderX.5.22.2026072503-alpha\HBuilderX\cli.exe launch mp-harmony --project d:\code2026\uniapp\uni-template-news_3.1.8 --deviceId AS@3DK0124528000470
卡住日志（只有这一行）：19:26:03.390 HBuilderX Version: 5.22.2026072503-alpha
- 使用HBuilder 5.07版本没有问题
构建指令：D:\HBuilderX\cli.exe launch mp-harmony --project D:\code2026\uniapp\uni-template-news_3.1.8 --deviceId 3DK0124528000470
构建日志：
19:41:31.915 HBuilderX Version: 5.07
19:41:32.133 项目 uni-template-news_3.1.8 开始编译
19:41:33.354 请注意运行模式下，因日志输出、sourcemap 以及未压缩源码等原因，性能和包体积，均不及发行模式。若要正式发布，请点击发行菜单或使用 cli 发布命令进行发布
19:41:33.354 正在编译中...
19:41:33.354 编译会生成大量临时文件，杀毒软件监控时会影响编译速度，并造成CPU升高。推荐把项目目录添加到杀毒软件的监控排除名单中。[添加] [帮助]
...
2 个回复
Ask小助手
好的，收到你的 Bug 反馈。作为 DCloud 官方人员，我对这个反馈进行如下评审和分析：
1. 反馈质量评审
这个 Bug 反馈的整体质量非常高，信息详实且对比清晰，为我们排查问题提供了很好的基础。
uni-template-news_3.1.8示例工程，属于公开可获取的标准模板，官方人员可以直接下载复现，无需额外调整。@AS、传@AS以及降级版本三种情况的日志输出，能够直接复现。评审结论：反馈非常有效，信息完整，无需额外补充即可进入排查阶段。
2. 问题分析与排查
根据你提供的信息和知识库，我们进行如下分析：
关于
deviceId参数格式问题：在 HBuilderX 5.15 及之后的版本中，CLI 运行到鸿蒙元服务（
mp-harmony）或鸿蒙应用（app-harmony）时，设备列表的输出格式发生了变化，会带有前缀（如你日志中的HUAWEI Mate 70 Pro【AS@3DK0124528000470】）。 当你不传@AS时，系统无法匹配到纯 ID3DK0124528000470，因此报错“未检测到指定设备”。当你补全为AS@3DK0124528000470后，设备匹配成功，但编译流程卡住。这说明deviceId` 的传参格式在 5.15+ 版本确实需要带上前缀，但这不是导致卡住的根因。关于编译卡住问题：
你提到在 5.07 版本一切正常，升级到 5.15 / 5.22 alpha 后卡在
HBuilderX Version输出这一行。结合知识库信息，这可能与以下几个因素有关：harmony-mp-configs/build-profile.json5，搜索useNormalizedOHMUrl确保值为true；检查harmony-mp-configs/entry/src/main/module.json5，确保dependencies中的 bundleName 为com.huawei.hms.ascfruntime，versionCode 为10006300。详见 鸿蒙元服务不兼容变化说明。--cleanCache true参数，强制清空构建缓存后重试。3. 解决方案与建议
建议你按以下步骤尝试修复：
清理构建缓存：
修改 CLI 构建指令，增加清空缓存参数，尝试重新构建：
检查并更新鸿蒙元服务配置：
按照上文提到的 4.51 版本不兼容变化处理指南，检查并修改项目中的
build-profile.json5和module.json5文件。检查 Node.js 环境：
在 CMD 中执行
node -v确认版本。如果低于 18，请升级 Node.js，或者将 DevEco Studio 自带的 Node.js 路径配置到系统环境变量的最前端。尝试界面运行模式：
如果纯 CLI 模式仍然卡住，可以尝试增加
--ui true参数，通过拉起 HBuilderX 可视化界面运行，以便在 IDE 控制台中观察更详细的错误日志：如果以上步骤均无法解决，这很可能是一个由特定版本 CLI 调用链路引发的 Bug。建议你在尝试
--ui true时，关注 HBuilderX 控制台是否有隐藏的错误堆栈，并通过【帮助 -> 查看运行日志】获取底层日志进行反馈。c***@tmp.dcloud.io (作者)
执行D:\HBuilderX.5.22.2026072503-alpha\HBuilderX\cli.exe launch mp-harmony --project d:\code2026\uniapp\uni-template-news_3.1.8 --deviceId AS@3DK0124528000470 --cleanCache true，运行日志报这个错误：
2026-07-28 19:54:23.342 [WARNING:] [PluginHost] TypeError: Cannot read properties of undefined (reading 'STARTING')
at f.start (D:\HBuilderX.5.22.2026072503-alpha\HBuilderX\plugins\uniapp-extension\out\index.js:12:70900)
at process.processTicksAndRejections (node:internal/process/task_queues:103:5)
要回复问题请先登录或注册
公告
更多>相关问题