onBackPress 必须写在页面.vue文件中才生效，是页面级生命周期钩子；仅对"backbutton"来源返回有效，H5平台不触发需降级用history.back()，iOS侧滑返回无法监听应禁用popGesture。
onBackPress 必须写在页面 .vue 文件里才能生效
它不是普通事件监听器，而是页面级生命周期钩子，只在当前页面实例中起作用。写在组件、App.vue 或 pages.json 里都无效。
常见错误包括：
- 把
onBackPress放在自定义组件（比如components/MyHeader.vue）中——完全不触发 - 试图在
App.vue里统一注册——只能用于双击退出等全局逻辑，无法控制单页行为 - 误以为
return false能拦截返回——实际只有return true才阻断默认跳转
onBackPress 的 from 参数决定是否该拦截
options.from 只有两个合法值："backbutton"（物理键 / 导航栏左上角返回）和 "navigateBack"（JS 主动调用 uni.navigateBack()）。你通常只该拦截前者。
如果不加判断直接拦截所有来源，会导致自己代码里的正常返回逻辑失效，比如表单提交后想回退一步，结果被强制跳到首页。
正确做法是：
- 先检查
if (options.from !== 'backbutton') return false - 只对
backbutton做弹窗或跳转处理 - 立刻
return true阻断，后续逻辑交给回调
H5 平台下 onBackPress 不触发，必须降级用 history.back()
浏览器地址栏后退、手势返回、history.back() 调用，均不会触发 onBackPress——这是浏览器机制限制，无法绕过。
真实项目中要运行时判断平台并切换逻辑：
- 用
uni.getSystemInfoSync().platform === 'h5'判断是否为 H5 - H5 下改用
window.history.back()，它不依赖 uni-app 页面栈 - 非 H5 平台调用
history.back()会报错，必须加条件包裹 - H5 刷新后
getCurrentPages()为空数组，此时uni.navigateBack()静默失败，属正常现象
iOS 侧滑返回无法监听，禁用 popGesture 是务实选择
iOS 右滑返回手势根本不会进入 onBackPress，官方明确不支持监听。强行补救会导致手势冲突、WebView 滚动异常、兼容性问题。
最稳妥的做法是在 pages.json 中关闭它：
{
"style": {
"popGesture": "none"
}
}
这个配置仅对 App 端生效，不影响 H5 和小程序。禁用后用户只能点左上角返回按钮，才能被 onBackPress 捕获。
真正容易被忽略的是平台差异的硬边界：H5 的 popstate 和 App 的物理键是两套系统，onBackPress 不是万能胶水，而是有明确适用范围的接口。
