Android WebView加载懒加载网站失败：白屏问题求助

• 添加网络权限
  在AndroidManifest.xml中添加INTERNET权限：

  <uses-permission android:name="android.permission.INTERNET" />
  

  如果加载HTTP协议的URL（非HTTPS），还需要在application标签中允许明文流量：

  <application
      ...
      android:usesCleartextTraffic="true">
  

• 完善WebViewClient的错误回调
  空的WebViewClient无法反馈加载错误，重写回调方法排查问题：

  webViewClient = object : WebViewClient() {
      override fun onReceivedError(
          view: WebView?,
          request: WebResourceRequest?,
          error: WebResourceError?
      ) {
          super.onReceivedError(view, request, error)
          // 打印错误信息，排查问题
          Log.e("WebView", "加载错误: ${error?.description}")
      }
  
      override fun onPageStarted(view: WebView?, url: String?, favicon: Bitmap?) {
          super.onPageStarted(view, url, favicon)
          Log.d("WebView", "开始加载页面: $url")
      }
  
      override fun onPageFinished(view: WebView?, url: String?) {
          super.onPageFinished(view, url)
          Log.d("WebView", "页面加载完成: $url")
      }
  }
  

• 添加WebChromeClient
  部分H5页面的交互、加载进度需要WebChromeClient支持，补充设置：

  webChromeClient = WebChromeClient()
  

• 验证URL有效性
  确保url变量是完整的合法地址，必须包含http://或https://前缀，比如"https://www.example.com"，而非相对路径或错误地址。

• 避免不必要的WebView重组
  给AndroidView添加key参数，防止Compose重组导致WebView重复创建：

  AndroidView(
      modifier = Modifier.fillMaxSize(),
      factory = { /* ... */ },
      key = url // 用URL作为key，仅当URL变化时重新创建WebView
  )
  

• 检查缓存与加载模式
  若怀疑缓存导致加载异常，可设置缓存模式为不使用缓存：

  settings.cacheMode = WebSettings.LOAD_NO_CACHE
  

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