iOS调用HTML5下载方法详解

示例 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() 后需手动清理已写入的临时文件

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《iOS调用HTML5下载方法详解》文章吧，也可关注golang学习网公众号了解相关技术文章。