You need to enable JavaScript to run this app. Swift 5 禁用WKWebView重定向跳转至外部应用的实现方法
优惠活动
大模型
产品
解决方案
定价
更多

Swift 5 禁用WKWebView重定向跳转至外部应用的实现方法

Swift 5 环境下禁用WKWebView外部App唤起跳转的实现

核心问题修正

你之前找到的旧代码在Swift 5下无法运行,主要有两个原因:

  • Swift 5 迭代后,WKNavigationDelegate的方法签名、系统基础API命名都做了规范更新,旧写法已经和当前SDK要求的接口不匹配,会直接报编译错误
  • 旧代码的拦截逻辑本身存在bug:把正常加载的https网页请求也纳入了拦截范围,等于所有正常网页都不让WKWebView加载,完全不符合实际使用需求

第一步:补全基础配置

当前你的WKWebView初始化代码只设置了uiDelegate,没有绑定navigationDelegate,这会导致导航拦截的代理方法根本不会触发,需要补全配置:

lazy var webView: WKWebView = {
    let webConfiguration = WKWebViewConfiguration()
    let webView = WKWebView(frame: .zero, configuration: webConfiguration)
    webView.uiDelegate = self
    // 新增:绑定导航代理,启用导航拦截能力
    webView.navigationDelegate = self
    webView.translatesAutoresizingMaskIntoConstraints = false
    return webView
}()

第二步:实现适配Swift 5的拦截逻辑

外部App唤起跳转的本质是网页发起了非http/https协议的自定义scheme导航请求(比如StockX的stockx://链接),我们只需要在导航请求发起前拦截这类请求,直接取消即可。
适配Swift 5的完整代理实现如下:

extension YourViewController: WKNavigationDelegate {
    func webView(
        _ webView: WKWebView,
        decidePolicyFor navigationAction: WKNavigationAction,
        decisionHandler: @escaping (WKNavigationActionPolicy) -> Void
    ) {
        // 拿到当前要发起的导航请求URL
        guard let targetURL = navigationAction.request.url else {
            decisionHandler(.allow)
            return
        }
        
        // 判断协议类型:仅放行http/https的网页请求
        // 其他自定义scheme(比如stockx://这类唤起外部App的链接)直接拦截取消
        if targetURL.scheme == "http" || targetURL.scheme == "https" {
            decisionHandler(.allow)
        } else {
            // 拦截非网页协议的跳转,禁止唤起外部App
            decisionHandler(.cancel)
        }
    }
}

补充说明

  • 该拦截逻辑可以覆盖两种常见的外部唤起场景:网页内JS触发的自定义scheme跳转、服务端返回的302重定向到自定义scheme的场景
  • 不要照搬旧教程里用UIApplication.shared.canOpenURL(_:)做拦截判断的逻辑:这个API的作用是判断目标App是否能打开指定链接,所有合法的https链接都会返回可打开,按这个逻辑判断会把所有正常网页请求都拦截,完全失去WKWebView的加载能力
  • 如果需要保留tel://(打电话)、mailto://(发邮件)这类系统协议的跳转权限,只需要在判断条件里把这类scheme加入白名单即可,其余非白名单的自定义scheme依然拦截
  • 不需要额外修改App的Info.plist配置,拦截动作发生在WKWebView发起导航请求的最前端,不会走到系统唤起外部App的流程

内容的提问来源于stack exchange,提问作者Chris

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.08 05:45:04