WKWebView为何违背预期加载缓存内容？

问题背景 #

• 每50次页面加载约有1次，WKWebView不发起新请求，直接加载本地缓存内容
• 使用默认URLRequest配置，未自定义缓存策略，预期遵循NSURLRequest.CachePolicy.useProtocolCachePolicy：

  let request = URLRequest(url: url)
  wkWebView.load(request)
  

• 服务器响应头Cache-Control配置为：public, max-age=9, s-maxage=2592000
• 日志显示WKWebView偶尔会自动将缓存策略切换为.returnCacheDataElseLoad——该策略会无视缓存时效直接使用本地缓存，仅在无缓存时才请求源站
• 当前仅能通过全量清除缓存临时解决问题，但此操作会清除图片等需长期缓存的内容：

  WKWebsiteDataStore.default().removeData(ofTypes: WKWebsiteDataStore.allWebsiteDataTypes(),
                                          for: records,
                                          completionHandler: {
  })
  

疑问 #

1. WKWebView为何会自动选择使用.returnCacheDataElseLoad策略？
2. 为何WebView会忽略后端的Cache-Control策略，直接加载缓存？

原因分析 #

1. WebKit内核的 fallback 机制：
   WKWebView在网络波动场景下（比如短暂断网、请求超时重试），内核会触发可用性优先的 fallback 逻辑，自动降级缓存策略到.returnCacheDataElseLoad，以此保证页面能正常显示，哪怕是旧内容。这种切换属于内核层面的隐式操作，不受业务代码的显式配置约束。

2. 默认缓存策略的灵活性：
   useProtocolCachePolicy并非严格强制执行服务器的Cache-Control规则，它允许WebKit根据自身逻辑（比如过往请求成功率、当前网络状态）灵活调整缓存行为。当内核判断缓存内容“足够可用”时，可能跳过缓存验证直接使用，甚至切换到更激进的缓存策略。

3. 缓存头指令的兼容性问题：
   服务器响应中的s-maxage=2592000是针对代理服务器的缓存指令，但WKWebView的内核可能误将其解析为客户端缓存的有效时长，与max-age=9的短时效规则产生冲突，导致内核逻辑错误触发强缓存策略。

解决方案建议 #

1. 显式指定严格缓存策略：
   绕过默认策略的不确定性，直接使用reloadRevalidatingCacheData策略——该策略会先向服务器发送条件请求验证缓存有效性，仅当缓存有效时才使用，否则请求新内容：

   let request = URLRequest(url: url, cachePolicy: .reloadRevalidatingCacheData, timeoutInterval: 60)
   wkWebView.load(request)
   

2. 仅清理目标URL的缓存：
   避免全量清除，只针对问题URL相关的缓存数据进行清理：

   WKWebsiteDataStore.default().fetchDataRecords(ofTypes: [WKWebsiteDataTypeDiskCache, WKWebsiteDataTypeMemoryCache]) { records in
       let targetRecords = records.filter { record in
           record.displayName.contains(url.host ?? "")
       }
       WKWebsiteDataStore.default().removeData(ofTypes: [WKWebsiteDataTypeDiskCache, WKWebsiteDataTypeMemoryCache],
                                               for: targetRecords,
                                               completionHandler: {})
   }
   

3. 添加请求头强制验证：
   在请求中显式添加Cache-Control: max-age=0，强制WebView向服务器验证缓存有效性：

   var request = URLRequest(url: url)
   request.setValue("max-age=0", forHTTPHeaderField: "Cache-Control")
   wkWebView.load(request)
   

内容的提问来源于stack exchange，提问作者Rafał Sroka