Swift5/iOS14.4下WKWebView中PDF内超链接无法打开的解决方法

问题核心原因 #

• iOS 14.4上的WKWebView对远程PDF的渲染走的是系统内置QuickLook兼容逻辑，并非完整的WebKit页面渲染流，PDF内嵌的超链接点击事件默认不会触发标准导航流程，所以会出现完全无响应的情况。
• 之前尝试拼接docs.google.com/viewer?url=方案无效、出现白屏，是因为Google文档查看器已经更新了跨域安全策略，禁止第三方嵌入场景下的外链跳转，点击链接时会被内容安全策略拦截，无法正常加载目标地址。

可落地的修复步骤 #

1. 补全WKWebView的基础配置 #

初始化WKWebView时开启必要的权限，否则后续的导航事件会被系统拦截：

let webConfig = WKWebViewConfiguration()
webConfig.preferences.javaScriptEnabled = true
// 打开跨域访问权限，允许PDF内嵌的链接触发导航
webConfig.setValue(true, forKey: "allowUniversalAccessFromFileURLs")
// 开启链接预览权限适配iOS14交互逻辑
webConfig.allowsLinkPreview = true

let webView = WKWebView(frame: self.view.bounds, configuration: webConfig)
webView.navigationDelegate = self
webView.uiDelegate = self

2. 实现关键代理方法（90%的无响应问题来自漏写这部分） #

注意：PDF内的超链接大多配置了新窗口打开的属性，WKWebView默认遇到这类新窗口请求时不会自动处理，需要通过WKUIDelegate的代理方法接管导航流程：

// 处理链接触发的新窗口请求
func webView(_ webView: WKWebView, createWebViewWith configuration: WKWebViewConfiguration, for navigationAction: WKNavigationAction, windowFeatures: WKWindowFeatures) -> WKWebView? {
    guard let targetURL = navigationAction.request.url else { return nil }
    // 直接在当前webView中加载目标链接，不新建WebView实例
    webView.load(URLRequest(url: targetURL))
    return nil
}

// 放开导航拦截，允许所有PDF触发的导航请求
func webView(_ webView: WKWebView, decidePolicyFor navigationAction: WKNavigationAction, decisionHandler: @escaping (WKNavigationActionPolicy) -> Void) {
    decisionHandler(.allow)
}

配置完成后直接加载目标PDF地址测试即可，不需要再拼接第三方查看器的前缀。

3. 兼容性兜底方案（适配仍有异常的场景） #

如果原生WKWebView配置后仍存在链接失效的问题，可以直接使用iOS14内置的PDFKit渲染PDF：

• 先把远程PDF文件下载到本地沙箱
• 用PDFView加载本地PDF数据，PDFKit原生支持PDF内所有超链接的点击跳转，不需要额外做事件监听，完全规避WKWebView的PDF渲染兼容问题。

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