onbackpress返回true才能拦截物理返回键，需先return true阻断默认行为，再弹窗并确认后手动调用uni.navigateback，同时用isconfirming状态防抖避免重复触发。

onBackPress 返回 true 就能拦截物理返回键，但直接弹窗 + uni.navigateBack() 容易出错，关键在“确认后手动触发返回”和“避免重复拦截”。

onBackPress 中 return true 的实际含义

只有明确返回 true，uni-app 才会放弃默认的页面返回行为。不写 return、写 return false、或返回其他值（比如 undefined），都会立刻执行默认返回——哪怕你前面已经调用了 uni.showModal()。

• 错误写法：onBackPress() { uni.showModal({ ... }); } → 弹窗还没点，页面已退
• 正确写法：onBackPress() { uni.showModal({ success: res => { if(res.confirm) uni.navigateBack(); } }); return true; }
• 注意：不能在 onBackPress 里用 async/await，否则返回值失效，拦截失败

Android 物理返回键 vs iOS 侧滑返回的兼容差异

iOS 侧滑返回完全不触发 onBackPress，这是硬限制，不是 bug。所以“退出前二次确认”在 iOS 上对侧滑无效，只能靠禁用手势 + 自定义返回按钮补救。

uni-app

uni-app 官方文档、npm 包和项目创建入口。

下载

• 禁用 iOS 侧滑：在 page.json 对应页面加 "popgesture": "none"，或运行时调用 plus.webview.currentWebview().setStyle({ popgesture: 'none' })
• 仅 Android 物理键和导航栏左上角按钮会走 onBackPress，且 event.from 都是 'backbutton'
• 支付宝小程序真机可监听，开发工具不触发；H5 平台基本不支持该事件

防止连续按两次返回键退出应用的逻辑漏洞

用户快速连按两次返回键，第一次弹确认框，第二次如果没做防抖，onBackPress 又被触发，可能造成弹窗重叠或直接退出。必须加状态锁。

• 用一个 data 字段（如 isConfirming）标记是否已在确认流程中
• 首次触发时设为 true，弹窗显示后立即返回 true；再次触发直接 return true，不重复弹窗
• 确认后手动调用 uni.navigateBack()，并重置 isConfirming = false
• 取消时也要重置，否则下次按返回键无响应

完整可用的退出确认模板（含防抖）

export default {
  data() {
    return {
      isConfirming: false
    }
  },
  onBackPress() {
    if (this.isConfirming) return true

    this.isConfirming = true
    uni.showModal({
      title: '提示',
      content: '确定要退出应用？',
      success: (res) => {
        if (res.confirm) {
          // 注意：这里不能用 uni.exitMiniProgram()，App 端需用 plus.runtime.quit()
          if (uni.getSystemInfoSync().platform === 'android' || uni.getSystemInfoSync().platform === 'ios') {
            plus.runtime.quit()
          }
        }
        this.isConfirming = false
      },
      fail: () => {
        this.isConfirming = false
      }
    })
    return true
  }
}

真正容易被忽略的是：H5 和小程序平台没有 plus.runtime.quit()，也不该退出，这段逻辑必须按平台区分；另外，如果项目用了 uni-simple-router 或类似路由插件，它的全局返回拦截可能覆盖页面级 onBackPress，得查插件文档看是否要关闭其默认行为。