必须将navigationstyle设为"custom"并写在pages.json对应页面的style中，才能彻底关闭原生导航栏，否则自定义按钮会被拦截或失效。
pages.json 里没关原生导航栏，自定义按钮就是摆设
自定义导航栏后点击返回没反应，第一反应不是代码写错了，而是原生导航栏还在那儿“抢事件”。navigationStyle 必须设为 "custom"，且必须写在 pages.json 对应页面的 style 里——不能只在某个 Vue 文件里加 style 块，也不能靠 uni.hideBackButton() 补救。
-
"navigationStyle": "custom"是唯一跨平台生效的开关，App、小程序、H5 全部认这个 - 如果漏配或配错位置（比如写在
globalStyle或页面<style></style>中），原生返回按钮仍会渲染并拦截点击 - H5 端额外注意：
hideBackButton: true只对默认导航栏有效，且仅 H5 支持；它和custom冲突，别混用
自定义按钮绑了 click，但没调用 uni.navigateBack() 或 history.back()
设成 custom 后，原生返回逻辑彻底消失，你得自己写。常见错误是：只写了 @click="goBack"，但 goBack 方法里没真正触发跳转，或者只写了 uni.navigateBack() 却没处理 H5 刷新后的页面栈清空问题。
- 必须手动调用
uni.navigateBack()（App/小程序）或history.back()（H5 刷新后getCurrentPages().length === 1时） - 别依赖
onBackPress拦截——它只响应系统返回键或左上角原生按钮，对自定义按钮无效 - 如果用了第三方 UI 库（如 uView 的
u-navbar），确认其custom-back插槽或属性是否真正透传到了点击事件里
自定义导航栏组件被 z-index 或 position 覆盖/错位
按钮点了没反应，有时根本不是逻辑问题，而是 DOM 层级或定位导致点击没落到目标元素上。尤其在 iOS 或某些安卓 WebView 中，浮动层错位后，实际点击区域可能偏移几十像素。
- 检查自定义导航栏容器是否设置了
position: fixed且z-index足够高（建议 ≥ 999） - 避免用
transform: translate()或负 margin 模拟居中，真机会导致点击热区偏移 - 在真机调试时打开“显示触摸反馈”（iOS 设置 → 辅助功能 → 触控 → 触摸提示），确认点击点是否落在按钮视觉区域内
- 如果用了
web-view，需通过currentWebview.setStyle()单独配置其 titleNView，页面内自定义按钮对其无效
App 端 web-view 页面里返回按钮失效
在 web-view 中嵌套网页时，自定义返回按钮常点不动——因为此时页面主体是 WebView 渲染的，Vue 组件的 @click 无法穿透到原生层，除非你主动接管。
- 必须在
load事件后，用page.$getAppWebview().setStyle()配置titleNView.buttons - 按钮
onclick回调里写uni.navigateBack()，而不是试图在 Vue 模板里绑定事件 -
autoBackButton: false必须显式设置，否则原生返回按钮会覆盖你的自定义按钮 - 别指望
onNavigationBarButtonTap在 web-view 页里触发——它只对 uni-app 原生页面有效
hideBackButton 相关代码，死守 navigationStyle: "custom" + 手动 uni.navigateBack() / history.back() 组合，再逐层排查层级和真机点击热区。
