Flutter WebView加载支付URL时iOS空白Android运行正常如何解决

• 最常见诱因是对URL做了多余的Uri.encodeFull处理：iOS端WebView的底层实现是WKWebView，对URL编码的校验规则比Android严格，如果传入的原始URL本身已经是符合规范的编码格式，二次编码会导致URL参数被异常转义，无法被服务端识别，直接触发加载失败。
• 其次是iOS ATS（应用传输安全）策略拦截：如果你的支付站点使用的TLS版本低于1.2、或者证书存在信任链不完整的问题，ATS默认会禁止加载请求，直接返回加载失败。
• 也可能是支付站点的反爬策略限制：部分支付网关会拦截无明确标识的WebView请求，Android的WebView默认UA和浏览器接近不会被拦截，但iOS WKWebView的默认UA可能被网关识别拦截。

步骤1：移除多余的URL编码 #

修改WebView的initialUrl参数，直接传入原始URL即可，不要二次编码：

// 修改前
initialUrl: Uri.encodeFull(url),
// 修改后
initialUrl: url,

如果你的URL中包含中文等特殊字符，可以改用Uri.parse(url).toString()做合规转换，避免过度编码。

步骤2：配置iOS端ATS权限 #

打开iOS项目的ios/Runner/Info.plist文件，添加如下配置：

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <false/>
    <key>NSExceptionDomains</key>
    <dict>
        <!-- 替换为你的支付站点域名 -->
        <key>xxxxxx.com</key>
        <dict>
            <key>NSExceptionAllowsInsecureHTTPLoads</key>
            <true/>
            <key>NSExceptionMinimumTLSVersion</key>
            <string>TLSv1.2</string>
            <key>NSIncludesSubdomains</key>
            <true/>
        </dict>
    </dict>
</dict>

如果还是无法加载，可以临时将NSAllowsArbitraryLoads设为true验证是否是ATS拦截导致的问题，确认后再调整为白名单配置安全性更高。

步骤3：添加错误回调和UA配置 #

修改WebView代码，添加错误捕获逻辑，同时自定义UA模拟浏览器标识，避免被支付网关拦截：

WebView(
  initialUrl: url,
  javascriptMode: JavascriptMode.unrestricted,
  // 自定义UA，模拟Safari浏览器标识
  userAgent: "Mozilla/5.0 (iPhone; CPU iPhone OS 16_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.0 Mobile/15E148 Safari/604.1",
  onWebViewCreated: (WebViewController webViewController) {
    _controller.complete(webViewController);
  },
  debuggingEnabled: true,
  // 添加资源加载错误回调，打印具体错误信息方便进一步定位
  onWebResourceError: (error) {
    print("WebView加载错误：${error.errorCode}, ${error.description}, ${error.url}");
  },
  onPageFinished: (String url) {
    SystemChannels.textInput.invokeMethod('TextInput.hide');
    if (url.contains("tap/check?tap_id")) {
      isFinshed = true;
    }
    print('Page finished loading: $url');
  },
)

步骤4：升级依赖版本 #

将pubspec.yaml中的webview_flutter依赖升级到最新稳定版，旧版本的iOS端实现存在大量已知的加载兼容性问题。

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