Jetpack Compose中AdvancedWebView后台恢复后空白需点击显示问题

可能原因 #

1. Compose AndroidView 后台恢复时的绘制触发缺失：应用从后台恢复时，Compose 重组可能未触发原生 View 执行完整重绘流程，而 WebView 需要主动触发绘制才能显示内容。
2. AdvancedWebView 硬件加速状态异常：后台时系统可能暂停了 WebView 的硬件加速，恢复后未自动重新启用或触发图层刷新，导致内容仅在交互时才会被渲染。
3. 透明背景的绘制层级冲突：设置透明背景后，WebView 的内容图层可能被其他视图覆盖，或系统未正确将其标记为需要重绘，只有交互操作才会强制刷新图层。
4. AndroidView 更新块的布局参数设置时机问题：当前在 update 块中设置布局参数，后台恢复时可能未正确触发视图的测量与布局，导致内容无法显示。

解决方案 #

1. 主动触发 WebView 重绘 #

监听应用生命周期，在恢复前台时强制 WebView 重绘：

// 在你的 Compose 可组合函数中添加
val lifecycleOwner = LocalLifecycleOwner.current
DisposableEffect(lifecycleOwner) {
    val observer = LifecycleEventObserver { _, event ->
        if (event == Lifecycle.Event.ON_RESUME) {
            webView?.let {
                it.invalidate()
                // 若 invalidate 无效，可尝试 reload（会保留页面状态）
                // it.reload()
            }
        }
    }
    lifecycleOwner.lifecycle.addObserver(observer)
    onDispose {
        lifecycleOwner.lifecycle.removeObserver(observer)
    }
}

2. 调整 WebView 硬件加速设置 #

强制启用硬件加速，或在恢复时重置图层类型：

// 在 AdvancedWebView 的初始化或 update 块中添加
it.setLayerType(View.LAYER_TYPE_HARDWARE, null)

3. 验证透明背景是否为诱因 #

临时将背景色改为非透明（如白色），测试问题是否消失：

// 替换原透明背景设置
setBackgroundColor(Color.WHITE)

若问题解决，说明透明背景与系统绘制逻辑冲突，可尝试用 Drawable 替代直接设置颜色：

setBackgroundDrawable(ColorDrawable(Color.TRANSPARENT))

4. 优化 AndroidView 布局参数设置 #

优先使用 Compose 修饰符控制尺寸，避免手动操作原生布局参数：

AndroidView(
    modifier = modifier.fillMaxSize(), // 用 Compose 修饰符控制尺寸
    factory = { ctx ->
        AdvancedWebView(ctx).apply {
            setBackgroundColor(Color.TRANSPARENT)
            webViewClient = this@MyActivity.webViewClient
            webChromeClient = this@MyActivity.webChromeClient
            addJavascriptInterface(webViewJsInterface, "Android")
            initSettings(this.settings)
            onWebView(this)
            loadUrl("https://example.com")
            webView = this
        }
    }
) {
    updateDarkTheme(it)
}

5. 排查第三方库适配问题 #

尝试用原生 WebView 替换 AdvancedWebView 进行测试，确认是否是第三方库的状态恢复逻辑问题。若为库的问题，可查看其源码或提交反馈。

内容的提问来源于stack exchange，提问作者Kevin Campos