uni.setNavigationBarColor 失效主因是平台兼容性与参数格式：H5不支持，uni-app x忽略background，微信需同时传frontColor和backgroundColor，APP端须禁用titleNView且navigationStyle为default；颜色值必须为标准六位十六进制（如#1e40af）和#000000/#ffffff，大小写、空格、简写均无效；微信需在pages.json预设navigationBarBackgroundColor并在onLoad调用；APP真机iOS还需uni.setStatusBarStyle同步状态栏文字色。
uni.setNavigationBarColor 调用后背景色没变？先看平台是否支持
这个 API 在 H5 端根本不存在，调用会直接报 undefined is not a function；在 uni-app x 中 background 相关参数被完全忽略，只保留 frontColor；微信小程序必须同时传 frontColor 和 backgroundColor，缺一不可；APP 端则要求原生导航栏未被禁用（即 "navigationStyle": "default"），否则调用无效。
颜色值写错导致全失效：十六进制、大小写、空格都敏感
常见错误不是逻辑问题，而是字符串格式踩坑：
-
frontColor只接受#000000或#ffffff，写成#000、#FFFFFF、white、rgb(0,0,0)全部不生效 -
backgroundColor必须是标准六位十六进制，如#1e40af，不能带空格：" #1e40af"会静默失败 - 哪怕只错一个字符，整个
uni.setNavigationBarColor调用都会被忽略，控制台也不报错
APP 端没生效？大概率是原生导航栏还开着
很多人在 pages.json 里配了 "app-plus": { "titleNView": { "backgroundColor": "#1e40af" } }，却还在 JS 里调 uni.setNavigationBarColor——这两者互斥。一旦启用 titleNView（即原生导航栏），JS API 就失去控制权；反之，若想用 JS 动态改色，必须确保 "navigationStyle": "default" 且未开启 titleNView。
检查点：
- 确认页面级
style中没有"navigationStyle": "custom" - 确认
globalStyle或页面style中没配titleNView - APP 端真机调试时，
uni.getSystemInfoSync().platform === 'ios'下还需额外调用uni.setStatusBarStyle同步文字色，否则白字压浅色背景就看不见
小程序端 onShow 里调用经常失灵？时机和配置方式不对
微信小程序不支持运行时动态更新导航栏样式，uni.setNavigationBarColor 只在当前页面生命周期内生效，且必须在 onLoad 阶段调用才稳定。如果放在 onShow，页面从后台切回时可能已错过渲染时机，尤其配合 tabBar 页面时，API 调用常被静默丢弃。
更关键的是：微信要求页面级 style 中必须预设 "navigationBarBackgroundColor"，否则 JS API 即使调成功，也可能因底层缺失 fallback 而不渲染。
正确做法：
- 在
pages.json对应页面的style中声明基础色："navigationBarBackgroundColor": "#1e40af" - 再在
onLoad中用uni.setNavigationBarColor覆盖（注意同时传两个 color） - 避免在
onShow或异步回调（如请求返回后）中调用，成功率极低
