onshow是唯一可靠监听页面返回的钩子,需结合getcurrentpages()判断来源页或跳转参数实现返回逻辑。

uni.navigateTo 传参后如何在目标页监听返回?
uni-app 没有原生的“监听页面返回”钩子,onUnload 或 onHide 都不能准确捕获用户点击左上角返回或物理返回键的动作——它们只在页面卸载时触发,但跳转到新页再返回时,原页面可能被缓存(尤其 tabBar 页面),onLoad 也不一定重新执行。
真正能感知“从 B 页返回 A 页”这一动作的,只有 onShow:它在页面每次显示时触发(包括从后台切回、从其他页返回),且比 onLoad 更可靠。
-
onLoad只在首次进入时执行,返回时不触发 -
onShow在每次显示时都触发,适合做“返回后刷新数据”“重置状态”等逻辑 - 如果需要区分“首次进入”和“返回”,可结合
getCurrentPages()判断当前栈深度或上一页路径
用 getCurrentPages() 获取页面栈判断返回来源
uni-app 的页面栈是数组,getCurrentPages() 返回当前所有页面实例,最后一个元素是当前页,倒数第二个是上一页。利用这个可以判断是否从特定页面返回。
onShow() {
const pages = getCurrentPages();
if (pages.length >= 2) {
const prevPage = pages[pages.length - 2];
if (prevPage.route === 'pages/detail/detail') {
console.log('是从 detail 页面返回的');
// 执行相应逻辑,比如刷新列表
this.refreshList();
}
}
}
- 注意:
route是页面注册时的路径(不含.vue后缀),不是 URL 路径 - 页面未被销毁时(如使用
uni.navigateTo而非uni.redirectTo),prevPage实例仍有效,可读取其data或调用方法(需提前暴露) - 若目标页是 tabBar 页面,
getCurrentPages()不包含 tabBar 页,返回时不会出现在栈中——此时只能靠全局状态或事件总线同步
跳转时传参 + 返回后 onShow 中读取
最轻量、最可控的方式:跳转时把标识或数据带上,返回后在 onShow 里检查并清理。避免依赖页面实例间耦合。
例如从列表页跳转到详情页,并希望返回后自动滚动到刚查看的项:
// 列表页跳转
uni.navigateTo({
url: '/pages/detail/detail?id=123&from=list'
});
// 列表页 onShow
onShow() {
const pages = getCurrentPages();
const currentPage = pages[pages.length - 1];
const query = currentPage.options || {};
if (query.from === 'list' && query.id) {
this.scrollToItem(query.id);
// 清除参数,避免下次 onShow 重复触发
delete currentPage.options.from;
delete currentPage.options.id;
}
}
-
currentPage.options是当前页的 URL 查询参数,跳转时带的id和from都会在这里 - 直接修改
currentPage.options是安全的,不影响路由系统,仅用于本页状态标记 - 不要依赖
onBackPress:它只在 App 端生效,H5 和小程序不支持,且无法区分是返回还是关闭应用
小程序平台下 onBackPress 的兼容性陷阱
onBackPress 看起来像“监听页面返回”,但它在不同平台行为差异极大:
- App 平台:支持,可拦截并自定义返回逻辑
- H5:完全不触发
- 微信小程序:仅在自定义导航栏且禁用原生返回按钮时才可能生效;原生左上角返回不会触发
onBackPress - 支付宝/字节小程序:部分支持,但需配置
navigationStyle: custom,且仍不可靠
所以除非你只做 App 端,否则不要把它当作“监听页面返回”的通用方案。真要拦截返回,应改用 uni.navigateBack 主动控制流程,或用 uni.showModal 提前确认,而不是事后监听。
真正稳定可靠的返回感知,始终落在 onShow + 参数传递 + 页面栈分析这三者组合上。复杂点在于多级跳转或嵌套路由时栈结构变深,容易误判;最容易被忽略的是 tabBar 页面不入栈,导致 getCurrentPages() 拿不到上一页信息——这时候得靠 uni.$emit / uni.$on 或 vuex/pinia 做跨页通信。











