custom导航栏下onBackPress不触发是预期行为，因uni-app将返回逻辑完全交由开发者接管；需在onLoad中调用uni.onBackPress注册监听，手动处理返回逻辑，并在onUnload中调用uni.offBackPress清理。
uni-app custom导航栏下onBackPress不触发怎么办
设置navigationStyle: "custom"后，原生导航栏被隐藏，onBackPress生命周期钩子默认不会响应物理返回键或左滑手势——这不是 bug，是预期行为：uni-app 认为“自定义导航栏 = 你全权接管导航逻辑”，包括返回动作。
必须手动监听并处理返回行为：
- 在页面
onLoad或onShow中调用uni.setNavigationBarColor（可选）和uni.hideHomeButton()（避免 iOS 底部 Home 指示条干扰视觉） - 使用
uni.onKeyboardHeightChange等无关，重点是：必须主动注册返回监听 - 调用
uni.onBackPress（注意：这是监听函数，不是生命周期），并在回调里执行uni.navigateBack()或跳转逻辑
示例：
export default {
onLoad() {
uni.onBackPress(() => {
// 这里写你的返回前校验逻辑，比如表单未保存提示
if (this.hasUnsavedChanges) {
uni.showModal({
title: '提示',
content: '内容未保存，确定离开？',
success: res => {
if (res.confirm) uni.navigateBack()
}
})
return true // 阻止默认返回，等用户确认
}
return false // 不阻止，交由 navigateBack 执行
})
}
}
为什么onBackPress要写在onLoad而不是onUnload
因为 uni.onBackPress 是全局事件监听器，注册后会一直生效，直到页面卸载或显式调用 uni.offBackPress。如果写在 onUnload，监听根本没机会注册；如果写在 onShow，可能因多次进入导致重复注册（虽然 uni-app 内部做了去重，但不推荐依赖）。
-
onLoad是最稳妥的注册时机：页面实例创建后、首次渲染前 - 务必在
onUnload中清理监听（尤其页面可能被缓存时）：uni.offBackPress() - 注意：App 平台支持物理返回键和手势；H5 平台需配合
history.pushState+window.onpopstate，uni-app 不自动处理 H5 的浏览器后退栈
H5平台返回按钮点击后页面不回退的常见原因
在 H5 上，即使写了 uni.navigateBack()，也可能表现为“点了没反应”或“URL 变了但页面没刷新”。这是因为 H5 的路由本质是 history 跳转，而 uni.navigateBack() 在 H5 下只是模拟，实际依赖 history.back()，但若之前用 uni.navigateTo 跳转时没触发真正的 history push（比如用了重定向或页面被 replace），就会断掉栈。
- 确保 H5 页面跳转统一用
uni.navigateTo（非redirectTo或reLaunch），否则navigateBack无历史可退 - 自定义返回按钮的
@click必须显式调用uni.navigateBack()，不能只写history.back()—— 后者绕过 uni-app 的页面栈管理，可能导致 data 不同步 - 如果用了 Vue Router 模式（
vue.config.js中配置了router: 'vue'），那应改用this.$router.back()，且uni.onBackPress在 H5 下无效，必须监听window.onpopstate
iOS 自定义导航栏左上角返回按钮点击区域太小
iOS 物理返回手势（右滑）能触发 onBackPress，但自定义按钮若仅靠图标，触控热区常不足 44×44pt，导致体验差甚至点不中。
- 不要只放一个
<image>，用<view class="back-btn"><image></view>包裹，并设padding: 12rpx或最小宽高80rpx - 加
catchtouchstart（而非@touchstart）防止父容器事件捕获干扰 - 真机调试时务必在 iOS 设备上测试手势返回是否仍有效——有些 CSS 层叠（如
z-index过高遮挡）会意外禁用系统手势
custom 导航栏的返回逻辑不是“配个样式就完事”，它把控制权完全交给你，连返回的时机、条件、动效、兼容性都要自己兜底。最容易被忽略的是 H5 的 history 行为差异和 iOS 手势与自定义按钮的共存细节。
