必须在App.vue中监听应用生命周期,因uni-app仅在此注册onLaunch、onShow等钩子;onLaunch仅冷启动执行一次,onShow每次前台恢复触发但无页面上下文;onError不捕获Promise reject,需onUnhandledRejection兜底;App.vue与页面onShow独立触发,无顺序关系。

只能在 App.vue 里监听应用生命周期,其他地方写无效。 这是硬性限制,不是推荐做法——框架根本不识别页面或组件里的 onLaunch、onShow 等函数。
为什么必须写在 App.vue?
uni-app 的应用级生命周期由宿主环境(小程序/APP/H5)直接触发,框架只在 App.vue 实例初始化时注册这些钩子。页面或组件实例根本不在这个调用链上,写了也等于没写。
-
onLaunch只在冷启动(首次打开 App 或小程序)时执行一次,参数是uni.getLaunchOptionsSync()的返回值,可用于判断启动场景(如从分享卡片进入、扫码、后台唤醒等) -
onShow每次从前台恢复都会触发,包括:切回前台、从其他 App 切回来、解锁手机后回到本应用 —— 它比onLaunch更常被误用于“每次刷新”,但注意它不带页面上下文,无法知道用户当前在哪页 -
onHide触发时机很“脆”:按 Home 键、弹出键盘、接电话、系统通知栏下拉都可能触发,不能假设它只代表“用户离开 App”
onError 和 onUnhandledRejection 怎么用才不漏报
这两个钩子是全局错误兜底,但默认不会捕获所有异常:
-
onError能捕获同步脚本错误、API 调用失败(如uni.request报错),但对 Promise reject 默认不响应 -
onUnhandledRejection必须显式监听未被捕获的 Promise 拒绝,且仅在 uni-app 2.8.1+ 支持(app-uvue 平台暂不支持) - 常见漏报场景:
setTimeout内抛错、addEventListener回调中 throw、uni.chooseImage成功回调里出错 —— 这些都不会进onError,需手动 try/catch
页面频繁切换时,onShow 在 App.vue 和页面里同时存在,谁先执行?
两者完全独立,无执行顺序关系:
-
App.vue的onShow是应用级事件,在整个 App 进入前台时触发,和当前页面无关 - 页面里的
onShow是页面级事件,在该页面显示到前台时触发(比如 tabBar 切换回来、uni.navigateBack返回) - 典型并发场景:用户从微信聊天页点击小程序链接进入,会先触发
App.vue的onShow,紧接着触发目标页面的onLoad→onShow - 别指望靠
App.vue的onShow去更新某个具体页面的数据,它没有页面实例引用,也没法调用this.$refs或uni.$emit
最易忽略的一点:onLaunch 和 onShow 的参数结构一致,但 onLaunch 的 options 可能为空对象(如 H5 端冷启动),而 onShow 的 options 在某些平台(如支付宝小程序)可能根本不存在 —— 务必加 if (options && options.path) 判断,否则直接报错。


















