微信小程序热更新-用户打开小程序时检测版本自动更新

在微信小程序中,「热更新」(也叫运行时更新)是指小程序发布新版本后,无需用户重新下载,自动检测并更新到最新版本的能力。

一、核心原理

通过微信小程序官方提供的 getUpdateManager API 实现,核心流程:

  1. 小程序启动 / 切前台时检测后台是否有新版本;
  2. 若有新版本,自动后台下载;
  3. 下载完成后提示用户重启小程序,加载新版本;
  4. 重启后小程序使用最新代码包,完成热更新。

二、完整实现代码(app.vue 中全局配置)

javascript 复制代码
<script setup>
import { onLaunch } from '@dcloudio/uni-app';

// 小程序启动时检测(核心时机)
onLaunch(() => {
  // 兼容低版本基础库
  if (!uni.canIUse('getUpdateManager')) return;

  const updateManager = uni.getUpdateManager();

  // 1. 检测是否有新版本
  updateManager.onCheckForUpdate((res) => {
    if (res.hasUpdate) {
      console.log('检测到新版本,后台自动下载中...');
    }
  });

  // 2. 新版本下载完成,提示重启
  updateManager.onUpdateReady(() => {
    uni.showModal({
      title: '版本更新',
      content: '已为您更新小程序,点击确定重启生效',
      cancelText: '稍后',
      confirmText: '确定',
      success: (res) => {
        if (res.confirm) {
          // 应用新版本并重启
          updateManager.applyUpdate();
        }
      }
    });
  });

  // 3. 新版本下载失败
  updateManager.onUpdateFailed(() => {
    uni.showToast({
      title: '更新失败,请手动清理缓存重试',
      icon: 'none'
    });
  });
});

</script>

若需强制更新(隐藏取消按钮),修改弹窗配置:

javascript 复制代码
uni.showModal({
  title: '版本更新',
  content: '必须更新才能继续使用',
  showCancel: false, // 隐藏取消按钮
  confirmText: '立即重启',
  success: (res) => {
    if (res.confirm) updateManager.applyUpdate();
  }
});

三、关键注意事项

  1. 生效范围:仅对「正式版」小程序生效(开发版 / 体验版不会触发);
  2. 更新时机:发布新版本后,微信服务器同步需 5-10 分钟,期间检测可能不触发;

四、验证流程

  1. 上传当前代码到小程序后台,发布「正式版 V1.0」;
  2. 修改代码(比如改版本号),再次上传、发布「正式版 V1.1」;
  3. 打开已安装 V1.0 的小程序,会自动检测到 V1.1 并下载;
  4. 下载完成后弹窗提示重启,重启后即加载 V1.1 版本。

五、与「热重载」的区别(再次明确)

特性 热更新(热更新) 热重载(开发者工具)
适用场景 正式版面向用户 开发阶段面向开发者
核心目的 更新线上小程序版本 开发时快速预览代码修改效果
状态保留 重启后状态重置 保留页面状态(输入框、变量等)
触发方式 发布新版本后自动检测 修改代码后自动触发

六、开发工具调试

七、与manifest.json 中版本号关系

小程序热更新的检测逻辑不依赖 manifest.json 里的版本号,也和你手动改的版本号数字高低无关。

1. 热更新的核心检测依据

微信小程序的热更新(getUpdateManager)是通过微信服务器存储的「代码包标识」 来判断是否有新版本,而非你配置的版本号:

  • 你每次上传代码到微信后台,不管 manifest.json 版本号是否修改,微信都会生成一个唯一的「代码包 ID / 哈希值」;
  • 当用户打开小程序时,客户端会对比「本地缓存的代码包 ID」和「微信后台最新的代码包 ID」:
  • ✅ 若不一致 → 判定为「有新版本」,触发热更新;
  • ❌ 若一致 → 判定为「无新版本」,不触发。
2. 关于 manifest.json 版本号的作用

manifest.json 里的 versionName(如 1.1.0)只是你手动维护的标识,作用是:

  • 方便你在后台「版本管理」里识别不同版本(比如标注 1.1.0 是 "修复提现 bug",1.1.1 是 "优化地址显示");
  • 方便在小程序内展示给用户看(比如页面上显示 "版本号:1.1.0");
  • 不参与热更新的检测逻辑 ------ 哪怕你上传代码时不改 manifest.json 版本号(仍写 1.0.0),只要代码内容变了,微信后台会生成新的代码包 ID,用户侧仍会检测到更新。
3. 正确的操作流程(以你的场景为例)
步骤 操作 说明
1 本地修改代码 比如修复 bug、加功能
2 (可选)改 manifest.json 版本号 从 1.0.0 改为 1.1.0(仅为标识,非必需)
3 上传代码到微信后台 生成新的代码包 ID
4 提交审核 → 发布正式版 微信后台将这个新代码包标记为 "最新正式版"
5 用户打开旧版本小程序 客户端检测到本地代码包 ID ≠ 后台最新 ID → 触发热更新
相关推荐
2401_878851012 小时前
微信小程序实战:掌握“手机状态”感知与设备 API 全解析
智能手机·微信小程序·notepad++
马哥python说19 小时前
我用DeepSeek Harness快速上线了一个情侣小程序
微信小程序·小程序·云开发
Jackzhang19 小时前
[端与游戏开发手记] 小程序第一次调接口,卡在域名白名单的那半天
微信小程序
djxzyr1 天前
微信小程序传感器实战:罗盘、加速计、陀螺仪与加速度实时波形
微信小程序·小程序
陈拉斯3 天前
无后端的人格测试小程序:当「数据不出设备」变成架构约束,我学到了什么
微信小程序
李纲明3 天前
微信小程序开了 Skyline 后样式全乱、滚动对不上甚至部分组件不能用?Skyline 怎么接才稳
javascript·微信小程序·小程序·devdiy
李纲明3 天前
微信小程序等位大桌被小桌占掉或过号回来就闹:先核桌型分队与过号容忍次数,再查门口屏与推送同源
微信小程序·devdiy·等位排队·桌型分队·过号重排·门口屏·推送同源
李纲明4 天前
微信小程序团课临开课才取消或空位没人补:先核取消时限与自动释放,再查候补确认与预扣回滚
微信小程序·devdiy·团课预约·取消时限·空位释放·候补确认·预扣回滚
用户034187671384 天前
用秒哒做了个拍照识餐小程序,上线两周踩的 4 个坑
微信小程序
李纲明4 天前
微信小程序租赁归还说本来就坏或配件对不上:先核借还点验与随单存证,再查差异计价公示
微信小程序·devdiy·租赁点验·借还拍照·随单存证·差异计价·押金释放