WebView中使用用户证书认证失败问题求助

当然可以实现！WebView默认不会主动触发系统证书选择对话框，这就是你遇到“无法访问”问题的原因。我们需要通过重写WebView的回调方法，手动处理服务器发起的客户端证书请求，下面是具体的实现步骤和修改后的代码：

核心原理 #

当服务器要求客户端提供证书时，WebView会调用WebViewClient中的onReceivedClientCertRequest方法。我们需要在这个方法里启动系统的证书选择界面，然后将用户选择的证书返回给服务器完成认证。

步骤1：添加权限 #

首先在AndroidManifest.xml中添加证书相关权限：

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

步骤2：修改WebView代码 #

我们需要扩展WebViewClient来处理证书请求，同时在Activity中处理证书选择的结果。以下是完整的修改后代码：

import android.content.Intent
import android.os.Bundle
import android.security.KeyChain
import android.webkit.ClientCertRequest
import android.webkit.WebChromeClient
import android.webkit.WebResourceRequest
import android.webkit.WebView
import android.webkit.WebViewClient
import androidx.appcompat.app.AppCompatActivity

class MainActivity : AppCompatActivity() {
    private val REQUEST_CODE_SELECT_CERT = 1001
    private var pendingCertRequest: ClientCertRequest? = null

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        val targetUrl = "你的需要证书认证的URL"
        val myWebView: WebView = findViewById(R.id.wv)

        // 配置WebViewClient，新增证书请求处理逻辑
        myWebView.webViewClient = object : WebViewClient() {
            override fun shouldOverrideUrlLoading(
                view: WebView?,
                request: WebResourceRequest?
            ): Boolean {
                // 让WebView自行处理所有URL加载
                return false
            }

            override fun onReceivedClientCertRequest(
                view: WebView?,
                request: ClientCertRequest?
            ) {
                super.onReceivedClientCertRequest(view, request)
                // 保存当前的证书请求，后续处理结果时使用
                pendingCertRequest = request
                request?.let {
                    // 启动系统证书选择对话框
                    val selectCertIntent = KeyChain.createChoosePrivateKeyIntent(
                        null,
                        it.host,
                        it.port,
                        it.keyTypes
                    )
                    startActivityForResult(selectCertIntent, REQUEST_CODE_SELECT_CERT)
                }
            }
        }

        // 你的WebChromeClient配置保持不变
        myWebView.webChromeClient = object : WebChromeClient() {
            override fun onJsAlert(
                view: WebView?,
                url: String?,
                message: String?,
                result: android.webkit.JsResult?
            ): Boolean {
                return super.onJsAlert(view, url, message, result)
            }

            override fun onJsConfirm(
                view: WebView?,
                url: String?,
                message: String?,
                result: android.webkit.JsResult?
            ): Boolean {
                return super.onJsConfirm(view, url, message, result)
            }

            override fun onJsPrompt(
                view: WebView?,
                url: String?,
                message: String?,
                defaultValue: String?,
                result: android.webkit.JsPromptResult?
            ): Boolean {
                return super.onJsPrompt(view, url, message, defaultValue, result)
            }
        }

        // 你的WebSettings配置保持不变
        myWebView.settings.apply {
            javaScriptCanOpenWindowsAutomatically = true
            javaScriptEnabled = true
            loadsImagesAutomatically = true
            loadWithOverviewMode = true
            domStorageEnabled = true
            builtInZoomControls = true
            allowContentAccess = true
        }

        // 加载目标URL
        myWebView.loadUrl(targetUrl)
    }

    // 处理证书选择的结果
    override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
        super.onActivityResult(requestCode, resultCode, data)
        if (requestCode == REQUEST_CODE_SELECT_CERT) {
            if (resultCode == RESULT_OK && data != null) {
                val certAlias = data.getStringExtra(KeyChain.EXTRA_PRIVATE_KEY_ALIAS)
                certAlias?.let { alias ->
                    try {
                        // 获取用户选择的证书链和私钥
                        val privateKey = KeyChain.getPrivateKey(this, alias)
                        val certChain = KeyChain.getCertificateChain(this, alias)
                        if (privateKey != null && certChain != null) {
                            // 将证书提交给服务器完成认证
                            pendingCertRequest?.proceed(privateKey, certChain)
                        } else {
                            // 无法获取证书，取消请求
                            pendingCertRequest?.cancel()
                        }
                    } catch (e: Exception) {
                        e.printStackTrace()
                        pendingCertRequest?.cancel()
                    }
                } ?: pendingCertRequest?.cancel()
            } else {
                // 用户取消选择证书，取消请求
                pendingCertRequest?.cancel()
            }
            // 重置待处理的请求对象
            pendingCertRequest = null
        }
    }
}

关键注意事项 #

• 证书导入：确保你的设备上已经导入了有效的客户端证书（通常是.p12或.pfx格式，可通过系统设置→安全→从SD卡安装证书完成导入，导入时需要输入证书密码）。
• Android版本兼容：如果你的应用适配Android 10及以上版本，KeyChain.getPrivateKey和KeyChain.getCertificateChain可能需要异步处理（可以使用KeyChainCallback），但上述代码在大多数场景下可以正常工作。
• 证书过滤：KeyChain.createChoosePrivateKeyIntent会根据服务器请求的host、port和keyTypes自动过滤符合要求的证书，用户只会看到可用的选项。

内容的提问来源于stack exchange，提问作者Víctor Martín