WKWebView 中需通过原生拦截下载：H5 用 window.webkit.messageHandlers.download.postMessage(绝对URL) 触发，原生在 webView(_:decidePolicyFor:decisionHandler:) 中拦截并用 URLSessionDownloadDelegate 下载，保存至 Documents 目录，务必 moveItem 避免文件丢失。
WKWebView 中拦截点击并调用原生下载
iOS App 内嵌 H5 时，click 事件无法直接触发 Safari 那样的下载行为 —— 尤其是 PDF、Excel 等非网页类型文件。必须由原生层接管下载逻辑，否则在 iOS 上会跳转空白页、打开预览或静默失败。
核心做法是：在 WKNavigationDelegate 的 webView(_:decidePolicyFor:decisionHandler:) 方法中拦截目标 URL（比如以 .pdf、.xlsx 结尾），调用 URLSession.downloadTask 下载，并保存到 Documents 目录。
- 务必检查
navigationAction.request.url是否非空且符合下载特征（后缀 or MIME） - 调用
decisionHandler(.cancel)阻止 WebView 加载该链接，否则可能白屏或崩溃 - 不要用
data:或 blob URL —— iOS WKWebView 不支持download属性，也无法解析本地 blob URL
HTML 侧如何安全传参给原生
H5 页面不能靠 实现真正下载，但可以配合 JS 桥接把 URL 交给原生处理。推荐使用 window.webkit.messageHandlers.xxx.postMessage(url)，这是最稳定、无跨域限制、不依赖 URL Scheme 的方式。
示例 HTML：
立即学习“前端免费学习笔记（深入）”；
document.getElementById('downloadBtn').addEventListener('click', function(e) {
e.preventDefault();
const url = this.dataset.url; // 推荐从 data-url 读取，避免拼接错误
window.webkit.messageHandlers.download.postMessage(url);
});
- 必须在 WKWebView 初始化前注册 handler：
userContentController.add(self, name: "download") - JS 里传的
url必须是**绝对 URL**（如https://api.example.com/file.pdf），相对路径会失败 - 避免传 blob URL 或 base64 字符串 —— 原生无法解析，也容易超长触发截断
原生下载任务必须处理的三个关键点
用 URLSessionDownloadDelegate 而不是普通 dataTask，因为只有下载任务能拿到临时文件路径，且支持后台续传和进度回调。
-
didFinishDownloadingTo回调里必须用FileManager.default.moveItem把临时文件移出沙盒缓存区，否则下次启动可能被系统清理 - 目标路径建议用
FileManager.default.urls(for: .documentDirectory, in: .userDomainMask).first!，别用Caches（会被系统自动清理） - 记得调用
URL.revokeObjectURL（前端）和释放 session（原生），否则内存/句柄泄漏在长周期 App 中很常见
iOS 17+ 和企业内网场景下的兼容性陷阱
如果文件走的是 HTTPS 但证书不被系统信任（比如自签名、内网 CA），URLSession 会直接失败，报错 NSURLErrorServerCertificateUntrusted —— 这时候用户看不到任何提示，下载就静默卡死。
- 开发阶段可临时实现
urlSession(_:didReceive:completionHandler:)并 accept challenge，但上线必须换可信证书 - 若服务端返回
Content-Disposition: inline，iOS 可能强制预览而非下载；确保响应头含attachment，例如：Content-Disposition: attachment; filename="report.pdf" - 大文件（>100MB）建议加进度 UI 和取消按钮，
downloadTask.cancel()后需手动清理已写入的临时文件
moveItem。 
