真机上 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 }。

uni-app

uni-app 是基于 Vue 的跨端开发框架，适合开发 H5、App、小程序、鸿蒙和多端业务应用。

下载

• 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，后续进入页先读缓存，再异步刷新
• 校验范围：若 statusBarHeight 44，视为异常，强制 fallback 到 25（多数安卓标准值）
• 注意：getSystemInfo 在某些低端安卓上会触发多次 success，建议用 once 标记防重复赋值

真实适配难点不在代码多寡，而在「不同厂商对「状态栏」的定义不统一」——有的把通知图标高度算进去，有的把信号格高度也混入，有的甚至把虚拟按键区误判为状态栏。所以别迷信单次 API 返回值，要结合设备 UA、平台类型、安全区兜底、用户实际视觉反馈来综合判断。