Android WebView 获取内容高度

在 Android 原生开发中，获取 WebView 的内容高度（Content Height）是一个常见的需求，但由于渲染异步性和屏幕密度（DPR）的存在，开发者经常会遇到获取值为 0 或数值异常大的问题。本文总结了最有效的获取方案及注意事项。

一、获取高度的三种主要方法

1. 原生方法：`getContentHeight()`

这是官方提供的最直接的方法。

返回值： 网页内容的原始高度，单位是 dp（设备独立像素）。
注意： 如果需要转换为物理像素（px），需乘以屏幕密度。

java 复制代码

// 获取内容高度（dp）
int contentHeightDp = webView.getContentHeight();

// 转换为物理像素（px）
float density = webView.getContext().getResources().getDisplayMetrics().density;
int contentHeightPx = (int) (contentHeightDp * density);

2. JS 注入法：`scrollHeight` (推荐)

通过注入 JavaScript 直接读取 DOM 树的实际高度，通常比原生方法更精准。

返回值： 网页内容的逻辑高度，单位是 CSS 像素。

Java

ini 复制代码

webView.evaluateJavascript("document.documentElement.scrollHeight", value -> {
    if (value != null && !value.equals("null")) {
        float cssHeight = Float.parseFloat(value);
        // 转换逻辑：px = CSS像素 * density
        float density = getResources().getDisplayMetrics().density;
        float actualPx = cssHeight * density;
        Log.d("WebView", "实际物理像素高度: " + actualPx);
    }
});

3. 实时监听法：`ResizeObserver`

适用于内容动态变化的页面（如折叠面板、异步加载数据）。

Java

typescript 复制代码

// 1. 注入 JavaScript 接口
webView.addJavascriptInterface(new Object() {
    @JavascriptInterface
    public void onHeightChanged(float height) {
        // 注意：此回调在子线程
        runOnUiThread(() -> {
            // 处理高度变化逻辑
        });
    }
}, "AndroidBridge");

// 2. 在 onPageFinished 中开启监听
webView.setWebViewClient(new WebViewClient() {
    @Override
    public void onPageFinished(WebView view, String url) {
        String js = "new ResizeObserver(entries => {" +
                    "  AndroidBridge.onHeightChanged(document.documentElement.scrollHeight);" +
                    "}).observe(document.body);";
        view.evaluateJavascript(js, null);
    }
});

二、关键问题排查

1. 为什么获取到的数值特别大？

原因： 单位不统一。

JS scrollHeight 返回的是 CSS 像素。
Android View 布局使用的是 物理像素 (px) 。
换算公式： 物理像素 = CSS像素 * 屏幕密度(density)。
在高分屏（如 density=3.0）上，1000px 的网页内容会返回 3000px 的物理高度。

2. 为什么获取到的值是 0？

原因： 调用时机过早。

loadUrl() 之后立即获取必定为 0，因为此时网页还没开始渲染。
建议： 在 onPageFinished 回调中，并配合 view.postDelayed(..., 200) 延时获取，以确保浏览器完成 Layout 计算。

三、最佳调用时机总结

时机	推荐指数	适用场景
onPageFinished + 延时	⭐⭐⭐⭐⭐	静态页面，加载完成后获取一次。
ResizeObserver (JS)	⭐⭐⭐⭐	动态页面，内容会随用户操作变长或缩短。
onProgressChanged > 80%	⭐⭐	追求极致响应速度，但高度可能不准确。

四、开发避坑指南

Viewport 设置： 确保 HTML 包含 <meta name="viewport" content="width=device-width, initial-scale=1.0">，否则 WebView 可能会按 980px 的默认宽度渲染，导致高度计算错乱。
线程安全： evaluateJavascript 的回调在 UI 线程，但 JavascriptInterface 的方法在 JavaBridge 线程（子线程），更新 UI 时必须切换回主线程。
高度自适应布局： 如果 WebView 在 ScrollView 中，建议高度设为 wrap_content，并在获取到高度后通过 params.height 手动更新 WebView 的布局参数。

Android WebView 获取内容高度

一、 获取高度的三种主要方法

1. 原生方法：getContentHeight()

2. JS 注入法：scrollHeight (推荐)

3. 实时监听法：ResizeObserver

二、 关键问题排查