记录 Android WebView内核更新,安全区 和 Insets 消费问题

大概2026刚过完年,线上 H5 页面中原本正常的弹窗,突然在底部多出了几十像素的透明空白。

第一反应是 Android 侧 Insets 的适配问题------但 Android 的 WebView 应该没有 iOS 那样原生支持 env(safe-area-inset-bottom) CSS 变量,按理说不应该有这个问题。

带着这个疑问开始排查。

排查过程

项目里使用的是 van-action-sheet 组件,通过 chrome://inspect 调试页面,在 DevTools 中检查样式,发现 padding-bottom: env(safe-area-inset-bottom); 是生效的, padding-bottom 的值不是 0。

这说明 Android WebView 已经将 Window Insets 信息注入到了 CSS 环境变量中。

翻阅 Android 官方文档后找到了答案:

了解窗口边衬区 | Android Developers

Android WebView 内核在 144 版本中会将系统窗口的 Inset CSS 环境变量的形式透传给 WebView 内的页面。一旦 Native 层没有正确"消费"这些 Insets,WebView 就会感知到它们,并反映到 safe-area-inset-* 变量上。

问题根因

常见的 Insets 处理写法如下:

kotlin 复制代码
ViewCompat.setOnApplyWindowInsetsListener(findViewById(android.R.id.content)) { v, insets ->
    val barInsets = insets.getInsets(WindowInsetsCompat.Type.navigationBars())
    v.updatePadding(bottom = barInsets.bottom)
    insets // 直接返回原始 insets,未消费
}

这段代码虽然给 View 加上了底部 padding,但 将原始 insets 原封不动地返回,意味着这些 Insets 没有被消费(consume)。子 View(包括 WebView)仍然可以感知到完整的 Insets 值,进而影响 CSS 环境变量。

解决方案

参考官方文档:Avoid ghost padding by zeroing insets

在处理完 Insets 后,构建一个新的 WindowInsetsCompat,将已处理的 Insets 类型置为 NONE,从而告知系统这部分 Insets 已被当前层级消费:

kotlin 复制代码
ViewCompat.setOnApplyWindowInsetsListener(findViewById(android.R.id.content)) { v, insets ->
    val types = WindowInsetsCompat.Type.navigationBars() or WindowInsetsCompat.Type.ime()
    val barInsets = insets.getInsets(types)
    v.updatePadding(bottom = barInsets.bottom)

    // 消费 navigationBars 和 ime,避免 WebView 感知到这些 Insets
    WindowInsetsCompat.Builder(insets)
        .setInsets(types, Insets.NONE)
        .build()
}

改动后,WebView 内 safe-area-inset-bottom 恢复为 0,弹窗底部的透明空白消失。

总结

对比项 修复前 修复后
Insets 返回值 原始 insets(未消费) 构建新的 WindowInsetsCompat(已消费)
WebView CSS 变量 safe-area-inset-bottom 非零 safe-area-inset-bottom 为 0
页面表现 弹窗底部出现多余透明空白 正常显示

结论: 在 Android 中,如果 Native 层自己处理了导航栏/IME 的 Insets,必须在监听器中返回消费后的 WindowInsetsCompat,否则 WebView 会继承这些 Insets 并将其映射到 CSS 的 safe-area-inset-* 环境变量,导致 H5 页面布局异常。

相关推荐
hai_android3 小时前
一行 asLiveData,背后是一座生命周期的桥
android·java·kotlin
阿杰m4 小时前
Android源码第二十三章:Telephony、RIL 与 IMS——来电怎么到应用?
android
booboosui4 小时前
没人认领 .md:安卓把报告交给了音乐播放器打开
android
用户60709759149066 小时前
AOSP 14 OTA 升级指导(四):update_engine 内部机制——Action 流水线与写盘
android
恋猫de小郭10 小时前
Jetpack Compose 1.13 发布,憋了这么久终有交代了
android·前端·flutter
JMchen12311 小时前
【Android 性能优化实战 60 讲】12 异步 Inflate 实战与痛击:源码拆解原生瓶颈,手写增强版布局预加载框架
android·性能优化·实战·启动优化·异步inflate·x2c
好的佩奇21 小时前
蓝牙之设备角色与连接
android·flutter·蓝牙
雨白1 天前
Android 消息机制剖析:从 Handler 投递到 Looper 循环的全链路
android
GY-931 天前
【Android】数据分层和依赖注入
android
传奇开心果编程1 天前
【Jetpack Compose娓娓道来】第44课:持久化——让数据“关掉App也不丢”
android·kotlin·移动开发·数据持久化·jetpack compose·ui框架·声明式ui