安装升级包失败：WGT安装包中manifest.json文件的appid不匹配

欢迎到专业群（ HBuilderX技术交流群 ） 咨询，群中有相关专业的管理员和群友。

“wgt 安装包中 manifest.json 的 appid 不匹配”这一报错，除了肉眼对比 appid 字符串是否一致外，还有几个常见但容易被忽略的点，请按下面顺序逐项核对：

1. 确认 wgt 包里的 manifest.json 确实被正确打包
   ‑ 有时旧包缓存导致上传的仍是上一版 wgt。重新执行 发行 → 制作应用升级包（wgt），生成后先手动解压验证，确保里面的 id 与项目根目录 manifest.json 完全一致。

2. 检查 manifest.json 中是否存在多余空格或不可见字符
   ‑ 用十六进制编辑器或 IDE 的“显示所有字符”功能，确认 id 前后没有空格、Tab、换行。

3. 确认热更新请求时携带的 appid 与 wgt 包一致
   ‑ 在调用 plus.runtime.install 前，把 plus.runtime.appid 打印出来，与 wgt 包里的 id 比对。
   ‑ 若使用自定义下载逻辑，确保服务器返回的 wgtUrl 对应的包就是刚才生成的那个，而不是旧包地址。

4. 客户端引擎版本差异导致校验失败
   ‑ 如果老版本 App 是用旧版 HBuilderX 打包，而新 wgt 是用新版 HBuilderX 生成，即使 appid 相同，uni 运行时也会因版本差异拒绝安装。
   ‑ 解决：在 manifest.json 里增加 "compatible": { "ignoreVersion": true }（HBuilderX 3.6+ 支持），强制跳过版本校验；或回退到与客户端同一主版本的 HBuilderX 重新编译 wgt。

5. 确认当前登录的 DCloud 账号拥有该 appid 的管理权限
   ‑ 只有项目作者账号才能对该 appid 进行热更新。登录 https://dev.dcloud.net.cn 查看项目归属，确保与 HBuilderX 登录账号一致。

按以上步骤逐项排查，一般都能定位到“看起来 id 一样却提示不匹配”的真正原因。