真机上 statusBarHeight 为 0 是因生命周期过早或厂商兼容问题，应于 onReady 中调用 uni.getSystemInfo 并设兜底值；优先使用 safeAreaInsets.top 适配异形屏，App 端需在 manifest.json 启用安全区域，H5 端用 env(safe-area-inset-top)；安卓需防抖缓存+范围校验（如>44px 则 fallback 至 25）。
uni-app 中 statusBarHeight 获取不到或为 0 怎么办
真机上 statusBarHeight 为 0，通常不是 API 调用错误，而是生命周期时机不对或平台限制。iOS 和部分安卓新机型（如华为 Mate 系列、小米折叠屏）在页面未完全就绪时无法准确读取状态栏高度。
正确做法是等 onReady 触发后再调用 uni.getSystemInfo，且必须加 success 回调判断——fail 或无回调时容易静默失败。
- 不要在
created或mounted中直接读取statusBarHeight，此时 DOM 和系统信息都未就绪 - 避免只依赖
uni.getSystemInfoSync().statusBarHeight，部分安卓厂商会返回 0（尤其 MIUI 13+、EMUI 12） - 推荐写法：
onReady() { uni.getSystemInfo({ success: (res) => { this.statusBarHeight = res.statusBarHeight || 20; // 兜底 20px }, fail: () => { this.statusBarHeight = 20; } }); }
如何让自定义导航栏真正贴顶、不被刘海/挖孔遮挡
仅靠 statusBarHeight 设置 padding-top 不够，因为异形屏的“安全区域”（safe area）还包含底部圆角、侧边滑动区等，uni-app 提供了 safeAreaInsets 但需手动启用。
关键点在于：H5 端不支持 safeAreaInsets，App 端需开启 safeArea 配置，否则即使获取到值也是默认 { top: 0, bottom: 0 }。
- App 端必须在
manifest.json → App SDK 配置 → 启用安全区域适配打钩（对应生成ios.safeArea和android.safeArea） - 获取安全区域后，优先用
safeAreaInsets.top替代statusBarHeight，它在 iOS 刘海屏和安卓挖孔屏下更准 - 示例：
uni.getSystemInfo({ success: (res) => { const top = res.safeAreaInsets?.top || res.statusBarHeight || 20; this.navTop = top + 'px'; } });
自定义导航栏在不同平台渲染错位的常见原因
错位往往不是高度算错，而是 CSS 渲染层叠逻辑被 uni-app 的条件编译或内置样式干扰。比如 H5 端默认有 padding-top: 20px，而 App 端没有；又或者使用了 uni-nav-bar 组件却手动加了 position: fixed，导致双倍定位。
- 禁用
uni-nav-bar的默认状态栏占位：在页面json中设"navigationStyle": "custom"，否则它会自己占高 - H5 端务必重置 body margin/padding：
/* H5 全局重置 */ @supports (padding-top: env(safe-area-inset-top)) { body { padding-top: env(safe-area-inset-top); } } - App 端避免同时设置
top: 0和padding-top，否则实际偏移 = statusBarHeight + top，造成下压
Android 厂商定制系统下状态栏高度异常（如返回 0 或 86px）
部分安卓机型（如 OPPO ColorOS 13、vivo OriginOS 3）对状态栏高度返回不一致：冷启动时为 0，热启动后才正常；或在横屏/分屏模式下返回错误值（如 86px 是误把状态栏 + 导航栏一起算进去了）。
不能只信一次结果，需要做缓存 + 容错校验。
- 加防抖：首次获取后存
localStorage，后续进入页先读缓存，再异步刷新 - 校验范围：若
statusBarHeight44，视为异常，强制 fallback 到 25（多数安卓标准值） - 注意：
getSystemInfo在某些低端安卓上会触发多次 success，建议用once标记防重复赋值
真实适配难点不在代码多寡，而在「不同厂商对「状态栏」的定义不统一」——有的把通知图标高度算进去，有的把信号格高度也混入，有的甚至把虚拟按键区误判为状态栏。所以别迷信单次 API 返回值，要结合设备 UA、平台类型、安全区兜底、用户实际视觉反馈来综合判断。
