Spring_CTH
Spring_CTH
  • 发布:2026-02-09 14:40
  • 更新:2026-02-09 15:42
  • 阅读:35

【报Bug】新机制 wgt更新后 重启app卡死、白屏

分类:uni-app

产品分类: uniapp/App

PC开发环境操作系统: Windows

PC开发环境操作系统版本号: w11

HBuilderX类型: 正式

HBuilderX版本号: 4.87

手机系统: Android

手机系统版本号: Android 16

手机厂商: 华为

手机机型: 红米k50

页面类型: vue

vue版本: vue2

打包方式: 云端

项目创建方式: HBuilderX

示例代码:

plus.runtime.install(downloadResult.tempFilePath, {
// force: false
force: true
}, function() {
uni.showToast({
title: "即将重启..."
})
setTimeout(() => {
uni.hideLoading()
plus.runtime.restart();
}, 2000)
}, function(e) {
console.log(e);
uni.showToast({
title: "更新失败"
})
uni.hideLoading()
});

操作步骤:

更新wgt包

预期结果:

更新成功重启成功

实际结果:

重启后白屏,关掉app进程后 重新打开正常

bug描述:

wgt包更新成功后执行plus.runtime.restart()方法后重启会卡在app的启动页然后白屏,除非把app的进程杀了再次启动就没问题了

2026-02-09 14:40 负责人:无 分享
已邀请:
Spring_CTH

Spring_CTH (作者) - Dcloud粉

能来个官方的人解决一下吗

DCloud_UNI_LXH

DCloud_UNI_LXH

试试这个方案呢:https://ask.dcloud.net.cn/question/144630

Ask小助手

Ask小助手

欢迎到专业群( uni-app 官方技术交流群 1 ) 咨询,群中有相关专业的管理员和群友。

作为 DCloud 官方人员,我对这条 bug 反馈进行如下评审:


✅ 反馈完整性评估

项目 是否完整 说明
BUG 标题 简洁明确,指出“wgt更新后重启卡死白屏”
BUG 描述 描述清晰,指出更新成功后调用 plus.runtime.restart() 会卡在启动页
代码示例 提供了完整的 plus.runtime.installplus.runtime.restart 使用逻辑
复现步骤 ⚠️ 仅有“更新wgt包”一句话,未说明是否首次安装、是否强制更新、是否特定机型
预期结果 合理,期望更新后正常重启
实际结果 明确指出“白屏,杀进程后正常”
分类信息 提供了完整的环境信息:HX版本、Android版本、Vue2、红米K50等

结论:复现步骤略显简略,建议补充是否首次热更新、是否强制更新、是否可复现于其他机型等。


✅ Bug 是否成立

根据知识库内容:

  • wgt热更新造成的差异 明确指出:wgt包与客户端引擎版本不一致时,可能导致异常行为,包括白屏、无法启动等问题。
  • release 4.57 中提到:Android平台曾修复“部分设备启动白屏或停留在启动界面无法启动”的Bug,说明这类问题确实存在。
  • 对话知识库中用户反馈 也有类似问题:wgt更新后重启卡在启动页,需手动杀进程才能恢复

结论:该 bug 成立,属于已知问题,可能与 wgt 包与客户端引擎版本不匹配有关,也可能与特定设备或系统版本有关。


✅ 是否为基本概念问题

  • 用户使用了 plus.runtime.restart(),这是 App 平台的标准 API,使用方式无误。
  • 未涉及鸿蒙平台、uni-app-x、uts 插件等不相关内容。
  • 未使用 uni.getUpdateManager(),避免了小程序平台误用问题。

✅ 官方建议(基于知识库)

  1. 确认版本兼容性:请确认你当前使用的 HBuilderX 版本(4.87)与 wgt 包的 uniCompileVersion 是否匹配老用户的 uniRuntimeVersion。如不匹配,建议回退 HBuilderX 版本重新编译 wgt 包。
  2. 使用官方升级方案:建议使用 uni-upgrade-center 进行 wgt 更新,已处理大量兼容性问题。
  3. 补充复现信息:请补充以下信息以便进一步定位:
    • 是否首次热更新就失败?
    • 是否所有 Android 设备都复现,还是仅红米 K50?
    • 是否强制更新(force: true)?
    • 是否可复现于 DevEco Studio 真机调试?

✅ 结论

该反馈有效且成立,属于已知问题范畴,建议用户根据上述建议进行排查与调整。若仍有问题,欢迎继续补充复现细节或联系官方技术支持。

内容为 AI 生成,仅供参考

要回复问题请先登录注册