Swift 4中WKWebView didFinish代理方法不触发问题求助

云上老周

2026-5-21

我来帮你排查WKWebView的didFinish代理没触发的问题，结合你的代码和日常开发里踩过的坑，整理几个关键修复点：

1. 先修复代理设置的强制类型转换问题

你的代码里webView1.navigationDelegate = self as! WKNavigationDelegate这种强转非常危险，而且如果你的ViewController没有显式遵守WKNavigationDelegate协议，这会直接导致代理无法正确绑定。正确的做法是：

先在类声明里添加协议：

class YourViewController: UIViewController, WKNavigationDelegate {
    // ... 你的其他代码
}

然后直接设置代理，不需要强转：

webView1.navigationDelegate = self

强制类型转换as!会掩盖“类未遵守协议”的编译错误，让系统无法正确识别代理对象，自然不会触发代理方法。

2. 确保代理设置在加载请求之前

如果你的代理是在调用load(request)之后才设置的，系统已经错过了捕获导航事件的时机，代理方法肯定不会触发。调整代码顺序：

let url = URL(string: "yourValidURL")!
let request = URLRequest(url: url)
// 先设代理，再加载请求
webView1.navigationDelegate = self
webView1.load(request)

另外还要检查webView的实例是否正确：如果是通过Storyboard/XIB创建的，要确保IBOutlet关联正确；如果是代码初始化的，要保证没有重复创建webView对象（比如代码里new了一个新的WKWebView，但设置代理的是另一个实例）。

3. 修复KVO监听的正确写法（如果需要用KVO替代代理）

你提到尝试用KVO监听loading属性，但代码没写完，正确的KVO实现应该是这样（要注意避免监听冲突和内存泄漏）：

// 在viewDidLoad里添加监听
override func viewDidLoad() {
    super.viewDidLoad()
    webView1.addObserver(self, forKeyPath: "loading", options: [.new, .old], context: &WebViewLoadingContext)
}

// 定义专属上下文常量，避免和其他KVO监听冲突
private var WebViewLoadingContext = 0

// 实现KVO的回调方法
override func observeValue(forKeyPath keyPath: String?, of object: Any?, change: [NSKeyValueChangeKey : Any]?, context: UnsafeMutableRawPointer?) {
    // 先判断上下文，确保是我们要处理的监听
    guard context == &WebViewLoadingContext else {
        super.observeValue(forKeyPath: keyPath, of: object, change: change, context: context)
        return
    }
    
    if keyPath == "loading", let isLoading = change?[.newKey] as? Bool, !isLoading {
        print("页面加载完成（KVO监听）：\(webView1.url ?? URL(string: "unknown")!)")
    }
}

// 记得在销毁时移除监听，防止野指针崩溃
deinit {
    webView1.removeObserver(self, forKeyPath: "loading", context: &WebViewLoadingContext)
}

4. 额外排查点

检查URL有效性：URL(string: "myURL")如果是无效URL或者自定义协议未处理，webView可能会加载失败，此时可以实现失败代理方法排查：

func webView(_ webView: WKWebView, didFail navigation: WKNavigation!, withError error: Error) {
    print("页面加载失败：\(error.localizedDescription)")
}

检查重定向情况：如果页面发生重定向，didFinish会在重定向完成后触发，你可以实现webView(_:didStartProvisionalNavigation:)来跟踪导航是否真的发起。

内容的提问来源于stack exchange，提问作者Vineesh TP