Android WebView无法加载Shopify结账页面问题求助

我们的WebViewActivity代码如下，其他网页均可正常加载，但Shopify结账页面始终处于加载状态无法完成；在默认Chrome浏览器中打开该页面则正常显示。已尝试将android.webkit.WebView迁移至androidx.webkit.WebView，问题仍未解决。

现有WebViewActivity代码 #

class WebViewActivity : AppCompatActivity() {

    private lateinit var binding: ActivityWebViewBinding

    private lateinit var webView: WebView

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        binding = ActivityWebViewBinding.inflate(layoutInflater)
        setContentView(binding.root)

        webView = findViewById(R.id.myWebView)
        webView.webViewClient = WebViewClient()  
        webView.settings.javaScriptEnabled = true  
        webView.loadUrl("https://us-xyz-dev.myshopify.com")

        if (WebViewFeature.isFeatureSupported(WebViewFeature.FORCE_DARK)) {
            WebSettingsCompat.setForceDark(webView.settings, WebSettingsCompat.FORCE_DARK_ON)
        }
        if (WebViewFeature.isFeatureSupported(WebViewFeature.SAFE_BROWSING_ENABLE)) {
            WebSettingsCompat.setSafeBrowsingEnabled(webView.settings, true)
        }

        WebView.setWebContentsDebuggingEnabled(true)

        if (WebViewFeature.isFeatureSupported(WebViewFeature.SAFE_BROWSING_ENABLE)) {
            WebSettingsCompat.setSafeBrowsingEnabled(webView.settings, true)
        }
    }
    override fun onBackPressed() {
        if (webView.canGoBack()) {
            webView.goBack()
        } else {
            super.onBackPressed()
        }
    }
}

问题排查与解决步骤 #

• 统一User-Agent
  Shopify结账页面可能针对客户端做适配，WebView默认User-Agent与Chrome不同，可手动设置Chrome风格的User-Agent：

  webView.settings.userAgentString = "Mozilla/5.0 (Linux; Android 10; SM-G973F) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Mobile Safari/537.36"
  

• 启用必要的WebView特性
  除JavaScript外，现代网页依赖的DOM存储等功能需手动开启：

  webView.settings.domStorageEnabled = true
  webView.settings.databaseEnabled = true
  webView.settings.setAppCacheEnabled(true)
  webView.settings.loadWithOverviewMode = true
  webView.settings.useWideViewPort = true
  

• 自定义WebViewClient处理页面状态
  重写WebViewClient，监控页面加载状态并处理可能的证书问题（测试环境可临时忽略证书错误，生产环境需谨慎）：

  webView.webViewClient = object : WebViewClient() {
      override fun onPageFinished(view: WebView?, url: String?) {
          super.onPageFinished(view, url)
          // 日志确认页面是否真正加载完成
          Log.d("WebViewDebug", "页面加载完成: $url")
      }
  
      override fun onReceivedSslError(view: WebView?, handler: SslErrorHandler?, error: SslError?) {
          // 测试环境临时处理，生产环境需验证证书后操作
          handler?.proceed()
      }
  }
  

• 清除WebView缓存
  旧缓存可能导致加载异常，初始化前清除缓存：

  webView.clearCache(true)
  webView.clearHistory()
  

• 确认网络权限
  确保Manifest中已添加必要权限：

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

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