微信小程序更新机制踩坑记录：updateInfo 为什么总是读到旧数据？

微信小程序更新机制踩坑记录：updateInfo 为什么总是读到旧数据？

摘要：

在 app.js 里用 updateInfo 维护更新日志，但升级时用户看到的始终是旧内容。原因：更新弹窗运行在旧版本代码中，读不到新版本数据（官方机制）。解决方式：更新弹窗只提示重启，更新内容放到新版本页面里展示

一、背景说明

我在做小程序版本升级时，有一个固定习惯：

在app.js里维护一个updateInfo配置，用来做两件事：

1. 记录版本信息
2. 在更新时告诉用户“这次改了什么”

大致结构是这样的（已做简化处理）：

updateInfo={version:'x.x.x',forceUpdate:true,updateLogs:{'x.x.x':['功能优化','体验改进','问题修复']}}

原本预期是：

用户升级时，可以在弹窗中看到当前版本的更新内容

但实际结果是：用户看到的始终是旧版本的更新日志
例如 我更新了 2.8.0 版本，弹窗永远看到的是 2.7.0 的更新日志

二、原因定位

查了官方文档后，结论很直接：

不是代码问题，是微信小程序更新机制决定的

关键点只有一句话：

更新弹窗运行在旧版本代码中

具体机制：

1. 小程序启动：

   • 使用本地旧包运行
   • 同时后台下载新版本

2. 更新提示出现时：

   • 仍然在执行旧代码
   • 无法访问新版本里的updateInfo

3. 新版本何时生效：

   • 必须等下一次冷启动

举个实际例子

• 本地版本：2.8.x
• 发布版本：2.9.x

流程：

1. 用户打开小程序 → 运行旧版本
2. 后台下载新版本
3. 弹更新提示 → 用的是旧版本代码
4. 读取的updateLogs→ 也是旧版本的

所以用户看到的永远是“旧内容”

四、当前实现逻辑（简述）

项目里做了两层更新相关逻辑：

1. 更新检测（checkForUpdate）

基于UpdateManager：

• 检测是否有新版本
• 下载完成后触发弹窗
• 调用applyUpdate重启

2. updateInfo 双分支

3. 更新亮点弹窗（补充）

额外做了一层“what’s new”：

• 用本地缓存记录版本
• 控制是否展示更新内容

作用：

把“更新内容展示”从系统更新弹窗里拆出来

五、最终解决方案

1. 更新弹窗只做一件事

forceUpdate:true

• 只提示“有新版本，需要重启”
• 不再展示updateLogs

2. 更新内容换位置展示

把updateLogs用在：

更新亮点弹窗（进入页面后展示）

这样有两个好处：

• 使用的是新版本代码 ✅
• 展示内容一定正确 ✅

3. updateInfo 的定位调整

从：

“更新弹窗的数据源”

变为：

“版本记录 + 更新亮点数据源”

六、长期建议

1. 固定策略

• 一律使用强制更新
• 更新弹窗不承载内容展示

2. 版本维护规范

每次发版只做两件事：

1. 更新version
2. 补充updateLogs

3. 测试方法

// 模拟升级wx.setStorageSync('last_seen_update_version','旧版本')// 模拟首次安装wx.removeStorageSync('last_seen_update_version')

七、参考资料

• 小程序更新机制
  https://developers.weixin.qq.com/miniprogram/dev/framework/runtime/update-mechanism.html

• UpdateManager
  https://developers.weixin.qq.com/miniprogram/dev/api/base/update/UpdateManager.html

八、结论

1. updateInfo 没问题，问题在机制

2. 更新弹窗读取的是旧包代码

3. 所以无法展示新版本内容

4. 正确做法是：

   • 更新弹窗只负责“重启”
   • 更新内容用独立弹窗展示