uni-app强制更新需用uni.getUpdateManager()配合服务端版本比对，避免误用系统版本；真机需确认update支持，安卓HBuilderX 3.1.0+才完整支持关键事件；弹窗应在启动300ms后、onUpdateReady时触发；静默更新需处理下载中断与厂商限制；失败后需资源路径隔离、API兼容及存储版本隔离。
uni-app 里怎么判断 App 版本是否需要强制更新
关键不是“弹不弹”，而是“怎么可靠比对版本号”。uni.getsysteminfosync() 拿不到当前安装包的 versionname，得用 uni.getupdatemanager() 配合服务端接口做决策。
常见错误是直接拿 plus.runtime.version（仅 5+ App）或 uni.getSystemInfoSync().version（iOS/Android 返回系统版本，不是 App 版本）去比对，结果永远错。
- 真机调试时，iOS 必须用
uni.getProvider({service: 'update'})确认支持，否则getUpdateManager返回null - 安卓端 HBuilderX 3.1.0+ 才完整支持
onCheckForUpdate和onUpdateReady，旧版本只能靠自己轮询接口 - 服务端返回的版本号格式必须和客户端一致（比如都用
"1.2.3"，别混用"v1.2.3"或1.2.3数字）
uni-app 强制更新弹窗的正确触发时机
不能在 onLaunch 里直接弹，用户还没进首页就卡住；也不能等用户点设置页才检查——强制更新就得拦在入口。
推荐做法：App 启动后 300ms 内发起版本检查，成功拿到服务端返回后再决定是否弹窗。避免白屏等待，也防止网络失败导致逻辑中断。
- 用
setTimeout包一层检查逻辑，避开 Vue 初始化耗时影响 - 弹窗前先调用
updateManager.onCheckForUpdate，但不要依赖它的回调——它只通知“有新包”，不保证可下载 - 真正触发下载要等
updateManager.onUpdateReady，此时再 showModal，用户点确定才执行updateManager.applyUpdate() - 如果服务端返回
force: true，且当前版本lt（小于）目标版本，就必须拦截后续路由跳转（比如用uni.preload+ 全局状态控制）
静默更新为什么经常失败？
静默更新 ≠ 后台自动装完，而是“不打扰用户完成下载 + 解压”，但安装仍需用户授权（iOS 完全不可静默，安卓部分厂商限制严重）。
很多开发者以为调了 updateManager.download() 就算静默，其实没处理好生命周期和错误分支，结果更新包下了一半就丢了。
-
updateManager.download()在 iOS 上实际走的是plus.downloader，失败时不会抛异常，得监听onHeadersReceived和onDownloadComplete - 安卓上某些 ROM（如华为 EMUI、小米 MIUI）会杀后台，导致下载中断，必须配合
plus.runtime.restart()前保存进度 - 静默场景下别用
uni.showModal，改用uni.showToast提示“正在升级”，否则用户切走 App 会导致弹窗丢失上下文 - 下载完成后的
applyUpdate()必须在前台执行，否则 iOS 直接忽略，安卓可能报错INSTALL_FAILED_USER_RESTRICTED
uni-app 升级失败后如何降级兼容
最麻烦的不是升不上去，而是升到一半失败，App 打不开、资源加载 404、API 调不通——因为新版的 static 或 uni_modules 已覆盖旧文件，但 JS 又没跑完。
没有银弹，只能靠两层兜底：构建时保留旧版静态资源路径，运行时用版本号动态拼 base URL。
- 构建输出目录加时间戳或版本号（如
dist/build/1.2.3/），Nginx 配置 fallback 到/dist/build/latest/ - JS 层请求 API 时，把
uni.getStorageSync('appVersion')插入 header，后端据此返回兼容字段（比如老版不返回new_feature字段） - 本地存储的 key 加版本前缀（如
storage_v123_user_token），避免新版代码读旧版缓存出错 - 如果
onUpdateFailed触发，立刻清除uni.setStorageSync('update_pending')标记，防止下次启动重复尝试
版本号比对、下载状态管理、失败回滚——这三块没串起来，所谓“强制”或“静默”都是假象。尤其要注意安卓不同厂商对 applyUpdate 的拦截策略，测试机至少得覆盖华为、小米、OPPO、vivo 和三星。
