webview.postUrl在Android 11及以上版本表单填充失效如何解决？

Android 11（API 30）开始，系统内置WebView升级到Chromium 83+内核，新增了POST表单提交的安全校验规则，原有低版本兼容的postUrl写法踩中规则限制就会出现post数据被丢弃、只加载空白表单的问题，常见触发原因有三个：

• post数据编码不符合规范：内核强制要求POST表单数据必须使用application/x-www-form-urlencoded格式编码，如果拼接参数时没有做URL编码、转byte数组时没有显式指定UTF-8字符集，内核会直接判定数据非法丢弃。
• 加载时序错误：Android 11+对WebView的加载状态校验更严格，如果在WebView还没完成视图挂载、内核初始化完成前就调用postUrl，请求会被降级成普通GET加载，自然不会携带提交的表单数据。
• 重定向逻辑变更：如果提交的目标地址服务端做了301/302跳转，Android 11+的WebView默认会在跳转时把POST请求转为GET请求，提交的表单数据会在跳转过程中被清空。

1. 先按规范处理post数据的编码

// 拼接表单参数，每个参数值必须做URL编码
val formParams = buildString {
    append("param1=").append(URLEncoder.encode("参数1的值", "UTF-8"))
    append("&param2=").append(URLEncoder.encode("参数2的值", "UTF-8"))
}
// 转字节数组必须显式指定UTF-8编码，禁止使用系统默认编码
val postByteData = formParams.toByteArray(Charsets.UTF_8)

2. 配置WebView基础设置，保证加载时序正确

webView.settings.apply {
    javaScriptEnabled = true // 表单页大多依赖JS做初始渲染，必须开启
    domStorageEnabled = true
    allowContentAccess = true
}
// 等WebView完成视图挂载、内核初始化后再发起post请求，避免时序问题
webView.post {
    webView.postUrl(targetSubmitUrl, postByteData)
}

3. 处理重定向丢数据问题
   给WebView设置自定义WebViewClient，拦截重定向请求，避免POST被自动转GET：

webView.webViewClient = object : WebViewClient() {
    override fun shouldOverrideUrlLoading(view: WebView, request: WebResourceRequest): Boolean {
        // 拦截POST触发的重定向，手动重新提交表单数据
        if (request.isRedirect && request.method.equals("GET", ignoreCase = true)) {
            view.postUrl(request.url.toString(), postByteData)
            return true
        }
        return super.shouldOverrideUrlLoading(view, request)
    }
}

• 测试时如果开启了WebView远程调试，Android 11+会拦截非可信来源的POST请求，验证功能时建议暂时关闭调试开关，或者打正式签名包测试。
• 不要给postUrl传null作为postData参数，哪怕没有需要提交的表单字段，也要传入"".toByteArray(Charsets.UTF_8)，传null在Android11+会直接触发空白表单加载。
• 如果表单页是本地存放在assets里的html文件，跨域提交数据时需要按需开启allowUniversalAccessFromFileURLs配置，线上公网页面不要开启这个配置避免安全风险。

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