在uni-app开发中处理App返回键的交互时,首先需要明确一个关键点:onBackPress仅应拦截物理返回键的触发。iOS的侧滑返回操作并不会进入这个回调。因此,正确的做法是在App.vue的onLaunch中,通过条件编译注册uni.onBackPress,这样既能避免重复绑定,也能防止平台报错。

onBackPress 里只拦截物理返回键,别拦死所有来源
用户点击右上角“返回”、调用uni.na vigateBack()、甚至页面栈自动退栈,这些都会触发onBackPress。但真正的拦截,只针对物理按键——无论是Android的实体返回键,还是iOS导航栏的返回按钮。其他来源一旦拦截,页面栈就会卡死,用户点击任何地方都无法退出。
判断的关键就是options.from === 'backbutton',这是唯一可信的信号。na vigateBack或pop这些值,都不要让它return true,否则用户点击任何地方都无法退出。
- 在
App.vue的onLaunch中注册监听:uni.onBackPress,不要在页面级组件里写 - 必须用
if (process.env.UNI_PLATFORM === 'app-plus')条件编译包裹整个逻辑,否则H5和小程序会报plus is not defined - 别重复绑定:每次进入App都重新注册一次监听,旧监听未
off,可能触发多次退出
双击退出逻辑必须放在 App.vue,且带时间戳防误触
双击退出不是“两次点击后执行”,而是“第一次点击设置标记,第二次点击检查间隔是否小于2秒”。
典型错误是把exitConfirm放在某个业务页的data中,结果用户从首页跳到商品页再按返回,双击逻辑直接失效。
- 在
App.vue的data中定义:exitTimestamp: 0 onBackPress里先检查options.from !== 'backbutton'就直接return- 然后对比
Date.now() - this.exitTimestamp:成立则调用退出;不成立则更新this.exitTimestamp = Date.now() - 退出前务必用
uni.showModal弹出确认框,内容别写“确定退出”,而要写“再按一次退出应用”,更符合用户预期
Android 用 plus.runtime.quit(),iOS 不能真退出,得降级处理
iOS系统禁止App主动退出,plus.ios.import("UIApplication").sharedApplication().performSelector("exit")在iOS 13+已失效,强行调用会静默失败或闪退。
目前可靠做法只有两个:一是调用plus.runtime.launchApplication({ action: 'QUIT' })跳转到系统设置页(部分机型支持);二是引导用户手动上滑关闭。后者更稳定,但需接受“无法强制退出”的事实。
- Android分支必须用
plus.runtime.quit(),它会立即终止进程,无回调 - iOS分支建议fallback到
uni.showToast({ title: '请上滑关闭应用', icon: 'none', duration: 2000 }) - 千万别在iOS上尝试
uni.exit()——这是H5 API,App端根本不存在,运行时报错 - 如果项目必须强退出iOS,只能走插件市场方案,比如“ios退出应用”插件,但需注意审核风险
H5 平台完全不走 onBackPress,必须单独降级
onBackPress在H5平台压根不触发。浏览器地址栏后退、Alt+←、手势返回,全绕过它。这不是bug,是浏览器安全机制决定的。
所以你不能靠统一入口处理“退出”,H5必须单独判断环境、单独实现逻辑,而且不能弹确认框后再执行history.back()——因为浏览器返回是同步不可逆操作,弹框还没关,页面已经跳走了。
- 先用
uni.getSystemInfoSync().platform === 'h5'判断环境 - 再检查
window.history.length > 1,避免history.back()执行后白屏 - 别替换
uni.na vigateBack(),H5下它依赖uni-app页面栈,刷新后栈为空,调用即静默失败 - 最稳妥的H5退出行为其实是:不退出,而是跳回首页 + 清空vuex/localStorage敏感数据
真实场景里最容易被忽略的,是iOS侧滑返回根本不会进onBackPress,哪怕你在pages.json里配置了"popGesture": "close",它也只影响页面退栈,不触发任何JS回调。这意味着你写的双击退出逻辑对侧滑完全无效——用户用手指一滑,App就没了,连确认机会都没有。
