You need to enable JavaScript to run this app. Swift开发:WKWebView内容渲染前自定义加载器不生效问题咨询
优惠活动
大模型
产品
解决方案
定价
更多

Swift开发:WKWebView内容渲染前自定义加载器不生效问题咨询

问题原因排查与修正方案

核心问题定位

  • 未绑定导航代理:代码中仅给webView设置了uiDelegate,完全没有赋值webView.navigationDelegate = self,导致所有导航相关的代理方法(didCommit/didFinish/didFail)都不会被系统回调,自定义加载逻辑根本无法触发。
  • 重复创建WKWebView实例:getPreviewAccToFileType方法在viewWillAppear中被调用,每次页面显示都会新建一个WKWebView添加到父视图,未销毁旧实例,既会造成内存泄漏,也可能出现加载请求混乱。
  • 缺失加载指示器的联动逻辑:现有代理方法仅做了日志打印,没有编写展示、隐藏自定义加载指示器的代码,即使代理正常触发也不会有UI变化。
  • PDF加载场景注意:WKWebView直接加载远程PDF文件时,页面正式渲染完成前的状态可以直接通过导航代理的生命周期方法联动,无需额外冗余的进度判断。

修正后的完整可运行代码

class PreviewFileViewController: UIViewController, WKUIDelegate, WKNavigationDelegate {
    // 仅初始化一次webView,避免重复创建
    private var webView: WKWebView!
    // 自定义加载指示器
    private let loadingIndicator = UIActivityIndicatorView(style: .large)
    
    override func viewDidLoad() {
        super.viewDidLoad()
        setupWebView()
        setupLoadingIndicator()
    }
    
    private func setupWebView() {
        webView = WKWebView(frame: otherDocumentView.bounds, configuration: WKWebViewConfiguration())
        webView.uiDelegate = self
        // 关键修复:绑定导航代理,让导航回调可以正常触发
        webView.navigationDelegate = self
        webView.autoresizingMask = [.flexibleWidth, .flexibleHeight]
        otherDocumentView.addSubview(webView)
    }
    
    private func setupLoadingIndicator() {
        loadingIndicator.center = view.center
        loadingIndicator.hidesWhenStopped = true
        view.addSubview(loadingIndicator)
    }
    
    func getPreviewAccToFileType(fileURL: String){
        guard let url = URL(string: fileURL) else { return }
        // 发起加载前展示加载指示器
        loadingIndicator.startAnimating()
        let request = URLRequest(url: url)
        webView.load(request)
    } 

    override func viewWillAppear(_ animated: Bool) {
        super.viewWillAppear(animated)
        getPreviewAccToFileType(fileURL: "https://api.digiboxx.com/uploads/6216FC50A9594500/1606288259_convert-jpg-to-pdf.net_2020-10-17_10-29-33_3.pdf")
     } 
}

extension PreviewFileViewController {
    func webView(_ webView: WKWebView, didCommit navigation: WKNavigation!) {
        debugPrint("开始接收页面渲染数据")
    }
    
    func webView(_ webView: WKWebView, didFinish navigation: WKNavigation!) {
        // 渲染完成后隐藏加载指示器
        loadingIndicator.stopAnimating()
        debugPrint("页面加载渲染完成")
    }

    func webView(_ webView: WKWebView, didFail navigation: WKNavigation!, withError error: Error) {
        // 加载失败时也要隐藏加载指示器
        loadingIndicator.stopAnimating()
        debugPrint("加载失败: \(error.localizedDescription)")
    }
}

可选优化建议

  • 如果需要匹配更精细的加载进度动画,可以通过KVO监听webView.estimatedProgress属性,同步自定义加载指示器的进度条变化。
  • 确保Info.plist中已配置对应HTTPS域名的ATS权限,避免加载请求被系统安全策略拦截。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.14 20:36:01