uni.setNavigationBarTitle在H5端无效、小程序可能静默失败，需在onLoad中调用，避开custom导航栏、nvue页面及字符串脏数据，并按平台分别处理。
uni.setNavigationBarTitle 在 H5 端完全无效，真机调试时在微信小程序上也可能静默失败——不是 API 写错了，而是调用时机、平台限制或页面配置冲突了。
onLoad 里调用才大概率生效
很多人把 uni.setNavigationBarTitle 写在 created 或 data 初始化里，此时原生导航栏根本没创建，调用等于白调。iOS 尤其严格：导航栏结构在页面创建时就已固化，不支持运行时重绘。
- 必须放在
onLoad或之后（onReady也可，但没必要） -
onShow里调用容易重复触发，安卓可能闪一下，iOS 直接忽略 - 如果标题依赖接口数据，
onLoad中先设个“加载中”，再在请求then里更新真实标题 - App 端偶发失效可加
setTimeout(() => uni.setNavigationBarTitle({ title }), 50)，比重试更轻量
custom 导航栏会让 uni.setNavigationBarTitle 彻底失效
一旦 pages.json 中该页面配置了 "navigationStyle": "custom"，原生导航栏就被隐藏了，uni.setNavigationBarTitle 就失去了作用对象——它改的不是你页面里写的 <view>，而是系统原生的那一栏。
- 检查 pages.json 对应页面的
style配置，确认没有"navigationStyle": "custom" - 若必须自定义（比如要加图标、渐变、胶囊适配），标题就得自己用
<view>实现，uni.setNavigationBarTitle完全不用管 - nvue 页面下该 API 不可用，只能走自定义方案
H5 和 App 端必须分开处理
uni.setNavigationBarTitle 在 H5 端只是改 document.title，和页面内视觉无关；App 端还分 vue2/vue3 时机差异，且需确认 titleNView 是否开启。
- H5 必须降级：
document.title = 'xxx'，别指望它做出原生效果 - App 端 vue2 要检查 manifest.json 中
titleNView是否开启；vue3 还得看 pages.json 的nvueStyle是否覆盖了标题设置 - 跨端统一写法：先判断平台，
if (uni.getSystemInfoSync().platform === 'h5') { document.title = title }，其余走uni.setNavigationBarTitle - 微信小程序不支持
titleNView，pages.json 里配了也无效
标题内容本身容易踩坑
传进去的字符串看着正常，但可能含零宽空格、BOM、连续空格，或超长——部分 Android 厂商系统会静默截断或渲染异常，这不是 bug，是底层限制。
- 赋值前强制清洗：
title.trim().replace(/\s+/g, ' ') - 长度建议 ≤12 字（UTF-16 单位），中文占 2，Android 显示上限常为 14~16，超长必省略且不可干预
- 避免从后端字段直拼标题，尤其带用户昵称时，先过滤控制字符，别依赖
encodeURIComponent - 微信小程序真机调试时，若基础库版本 >3.4，低版本
setNavigationBarTitle可能静默失败，建议切到 3.2.x 测试
真正麻烦的不是 API 怎么写，而是你得同时盯住生命周期、页面配置、平台差异、字符串质量这四条线——漏掉任何一条，标题就不动。
