Swift 5下WKWebView的canGoForward始终返回false问题求解

云上老周

2026-10-7

WKWebView canGoForward始终返回false问题解决方案

问题根因

你当前仅在导航响应、页面加载完成两个代理节点更新按钮状态，但WKWebView的canGoBack、canGoForward属性的变化触发场景不止这两个：当用户执行回退操作、导航栈发生变更时，属性状态会实时更新，但不一定会触发你当前用到的两个代理方法，导致前进按钮状态没有同步更新。

解决方案

通过KVO监听WKWebView的canGoBack、canGoForward属性变化，只要属性值发生变更就同步更新按钮状态，该方案可以覆盖所有导航栈变更的场景，不需要依赖代理回调。

步骤1：初始化WKWebView后注册KVO监听

// 替换为你自己的webView实例变量名
webView.addObserver(self, forKeyPath: #keyPath(WKWebView.canGoBack), options: [.new], context: nil)
webView.addObserver(self, forKeyPath: #keyPath(WKWebView.canGoForward), options: [.new], context: nil)

步骤2：实现KVO监听回调方法

override func observeValue(forKeyPath keyPath: String?, of object: Any?, change: [NSKeyValueChangeKey : Any]?, context: UnsafeMutableRawPointer?) {
    guard let targetWebView = object as? WKWebView, targetWebView == webView else {
        super.observeValue(forKeyPath: keyPath, of: object, change: change, context: context)
        return
    }
    // 只要两个属性任意一个发生变化，就更新按钮状态
    if keyPath == #keyPath(WKWebView.canGoBack) || keyPath == #keyPath(WKWebView.canGoForward) {
        buttonConfiguration(webView: targetWebView)
        return
    }
    super.observeValue(forKeyPath: keyPath, of: object, change: change, context: context)
}

步骤3：页面销毁时移除KVO监听，避免内存泄漏

deinit {
    webView.removeObserver(self, forKeyPath: #keyPath(WKWebView.canGoBack))
    webView.removeObserver(self, forKeyPath: #keyPath(WKWebView.canGoForward))
}