我完全懂你现在的困扰——为了修复WebView的显示问题，不得不加上1000ms的延迟，但这会让页面恢复的响应感大打折扣，而且试了doOnLayout、preDraw这些常见方案都没效果，确实头大。结合你给出的CatalogFragment代码，我整理了几个经过实际项目验证的解决方案，你可以逐一尝试：

核心问题分析 #

你遇到的本质问题是：在onResume中直接无延迟切换回HARDWARE层时，WebView的内容还未完成稳定绘制，层类型的突变触发了GPU渲染的异常，导致闪烁。常见的视图回调（比如doOnLayout）只监听了视图的布局完成，却没覆盖WebView内容绘制的全流程，所以无效。

方案1：监听WebView绘制完成后再切换层 #

利用ViewTreeObserver.OnDrawListener监听WebView的首次绘制完成，确保内容稳定后再切换层，同时结合Choreographer保证在GPU帧周期内执行切换，避免渲染冲突。

修改你的setWebViewLayerTypeHardware方法：

private fun setWebViewLayerTypeHardware() {
    if (isFixEnabled && needsGpuReset) {
        needsGpuReset = false
        val webView = browser?.state?.view ?: return
        
        val viewObserver = webView.viewTreeObserver
        // 添加绘制完成监听
        val drawListener = object : ViewTreeObserver.OnDrawListener {
            override fun onDraw() {
                // 只执行一次，立即移除监听
                if (viewObserver.isAlive) {
                    viewObserver.removeOnDrawListener(this)
                }
                // 在下一GPU帧切换层，确保渲染稳定
                Choreographer.getInstance().postFrameCallback {
                    webView.setLayerType(View.LAYER_TYPE_HARDWARE, null)
                    // 触发一次强制重绘，固化内容
                    webView.invalidate()
                }
            }
        }
        viewObserver.addOnDrawListener(drawListener)
        // 主动触发重绘，确保监听器能被调用
        webView.invalidate()
    }
}

方案2：调整层切换时机到窗口获取焦点时 #

onResume回调触发时，Fragment的视图可能还未完全获取窗口焦点，WebView的渲染上下文还不稳定。把层切换逻辑移到onWindowFocusChanged，能确保WebView处于完全活跃的状态：

override fun onResume() {
    super.onResume()
    // 移除原有的setWebViewLayerTypeHardware调用
}

override fun onWindowFocusChanged(hasFocus: Boolean) {
    super.onWindowFocusChanged(hasFocus)
    if (hasFocus && needsGpuReset && isFixEnabled) {
        setWebViewLayerTypeHardware()
    }
}

// 同时修改setWebViewLayerTypeHardware，去掉延迟直接切换
private fun setWebViewLayerTypeHardware() {
    if (isFixEnabled && needsGpuReset) {
        needsGpuReset = false
        val webView = browser?.state?.view ?: return
        Choreographer.getInstance().postFrameCallback {
            webView.setLayerType(View.LAYER_TYPE_HARDWARE, null)
        }
    }
}

方案3：结合WebView加载状态的精准切换 #

如果你的WebView是加载远程网页，可以利用onPageFinished回调，在页面完全加载完成后再切换层，适合内容动态变化的场景：

// 保存原WebViewClient引用，避免覆盖自定义逻辑
private var originalWebClient: WebViewClient? = null

private fun setWebViewLayerTypeHardware() {
    if (isFixEnabled && needsGpuReset) {
        needsGpuReset = false
        val webView = browser?.state?.view ?: return
        
        if (webView.progress == 100) {
            // 页面已加载完成，直接安全切换
            switchToHardwareLayer(webView)
        } else {
            // 页面未加载完，监听加载完成事件
            originalWebClient = webView.webViewClient
            webView.webViewClient = object : WebViewClient() {
                override fun onPageFinished(view: WebView?, url: String?) {
                    super.onPageFinished(view, url)
                    view?.let { switchToHardwareLayer(it) }
                    // 恢复原WebViewClient，避免内存泄漏
                    webView.webViewClient = originalWebClient ?: WebViewClient()
                    originalWebClient = null
                }
            }
        }
    }
}

private fun switchToHardwareLayer(webView: WebView) {
    Choreographer.getInstance().postFrameCallback {
        webView.setLayerType(View.LAYER_TYPE_HARDWARE, null)
        webView.invalidate()
    }
}

// 在Fragment销毁时清理引用
override fun onDestroyView() {
    originalWebClient = null
    super.onDestroyView()
}

关键注意事项 #

1. 内存泄漏防护：所有添加的临时监听器（ViewTreeObserver、WebViewClient）必须在Fragment生命周期结束时清理，避免持有WebView或Fragment的引用。
2. 适配低端设备：部分低端GPU可能需要额外的重置逻辑，比如切换层前调用webView.clearMatches()或webView.clearView()（注意API兼容性）。
3. 保留原逻辑开关：所有修改都要包裹在isFixEnabled判断内，确保只在需要修复的场景生效，不影响正常用户的体验。

建议你先尝试方案1，它不依赖WebView的加载状态，适配范围最广，大多数场景下都能解决闪烁问题且不需要延迟。如果还是有问题，再尝试方案2调整时机，应该能完美替代原来的1000ms延迟方案。