升级至macOS Sonoma后Mac Catalyst应用WKWebView无法加载PDF求助

针对Mac Catalyst升级至macOS Sonoma后WKWebView无法加载PDF的问题，可从以下方向排查解决：

1. 先获取具体加载错误信息 #

通过WKNavigationDelegate的回调捕获加载失败的详细错误，精准定位问题根源：

func webView(_ webView: WKWebView, didFail navigation: WKNavigation!, withError error: Error) {
    print("PDF加载失败: \(error.localizedDescription)")
    if let nsError = error as NSError? {
        print("错误码: \(nsError.code), 错误域: \(nsError.domain)")
    }
}

func webView(_ webView: WKWebView, didFailProvisionalNavigation navigation: WKNavigation!, withError error: Error) {
    print("PDF加载初始化失败: \(error.localizedDescription)")
}

2. 本地PDF改用loadFileURL加载 #

Sonoma对Mac Catalyst的文件权限校验更严格，若加载本地PDF，替换原load(request)方法为loadFileURL，同时指定文件访问范围：

// 假设url是本地PDF文件的URL
self.webView.loadFileURL(url, allowingReadAccessTo: url.deletingLastPathComponent())

3. 检查App Sandbox文件权限 #

若访问本地文件，确保沙箱配置正确：

• 访问用户手动选择的文件：开启User Selected File的Read权限
• 访问应用容器内文件：确保文件存放在Application Support或Documents目录（默认有权限）
• 需访问特定目录：在Sandbox设置中添加对应权限，比如com.apple.security.files.user-selected.read-write

4. 调整WKWebView配置 #

尝试修改配置项，适配Sonoma的WebView规则：

let webConfiguration = WKWebViewConfiguration()
// 启用内联媒体播放，部分PDF渲染依赖此设置
webConfiguration.allowsInlineMediaPlayback = true
// 若PDF加载仍异常，可尝试注释选择粒度设置
// webConfiguration.selectionGranularity = .character

let preferences = WKPreferences()
preferences.javaScriptEnabled = true
preferences.javaScriptCanOpenWindowsAutomatically = true
webConfiguration.preferences = preferences

5. 验证PDF文件兼容性 #

• 用系统预览打开目标PDF，确认文件无损坏或加密
• 测试公开的标准PDF（如https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf），排查是否为特定PDF的兼容性问题

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