能否保存WKWebView内容（含图片）用于离线阅读？如何实现？

首先直接给结论：WKWebView本身支持离线缓存，但默认机制无法完全满足「无网络时查看完整含图网页」的需求，需要通过合理配置或自定义实现来达成，同时要避开私有API和UIWebView的旧方案。

下面分几种可行的实现思路，按可控程度从易到难排序：

1. 利用WKWebView内置缓存配置快速实现 #

WKWebView自带基于WKWebsiteDataStore的缓存体系，只要正确配置，就能让它自动缓存网页资源：

• 创建WKWebViewConfiguration时，指定使用持久化的数据存储（默认就是，但可以显式设置确保）：

  let configuration = WKWebViewConfiguration()
  // 使用持久化存储，缓存会保存到磁盘
  configuration.websiteDataStore = WKWebsiteDataStore.default()
  // 允许从本地文件加载资源，适配离线场景
  configuration.preferences.allowsFileAccessFromFileURLs = true
  let webView = WKWebView(frame: .zero, configuration: configuration)
  

• 配合HTTP请求的缓存策略：在加载网页时，给URLRequest设置合适的缓存策略，比如在线时优先用缓存、无缓存再请求；离线时直接用缓存：

  var request = URLRequest(url: webUrl)
  if NetworkManager.isOffline { // 这里需要自己实现网络状态判断逻辑
      request.cachePolicy = .returnCacheDataDontLoad
  } else {
      request.cachePolicy = .returnCacheDataElseLoad
  }
  webView.load(request)
  

这种方式优点是简单，不需要额外复杂代码，但缺点是对缓存的可控性差，比如无法强制缓存所有资源、无法自定义缓存路径等。

2. 自定义NSURLCache实现可控缓存 #

WKWebView会共享App全局的NSURLCache，所以我们可以自定义一个缓存类来接管所有网页资源的缓存逻辑，确保图片、HTML、CSS等所有资源都被缓存：

• 自定义NSURLCache子类，重写缓存相关方法（可选，主要是为了更精细控制）：

  class CustomWebCache: NSURLCache {
      override func storeCachedResponse(_ cachedResponse: CachedURLResponse, for request: URLRequest) {
          // 可以在这里过滤需要缓存的资源类型，比如只缓存图片、HTML、CSS等
          super.storeCachedResponse(cachedResponse, for: request)
      }
  
      override func loadCachedResponse(for request: URLRequest, completionHandler: @escaping (CachedURLResponse?) -> Void) {
          // 离线时强制返回缓存，在线时正常读取
          if NetworkManager.isOffline {
              super.loadCachedResponse(for: request, completionHandler: completionHandler)
          } else {
              super.loadCachedResponse(for: request, completionHandler: completionHandler)
          }
      }
  }
  

• 在App启动时设置全局缓存：

  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
      // 设置内存缓存50MB，磁盘缓存500MB，自定义缓存路径
      let customCache = CustomWebCache(memoryCapacity: 50 * 1024 * 1024,
                                       diskCapacity: 500 * 1024 * 1024,
                                       diskPath: "CustomWebCache")
      NSURLCache.setSharedURLCache(customCache)
      return true
  }
  

这种方式可控性强，能确保所有需要的资源都被缓存，而且完全使用公开API，不会有审核风险。

3. 预加载资源到本地（完全离线场景） #

如果需要确保特定网页100%离线可用，可以提前把网页的所有资源（HTML、图片、CSS、JS）下载到本地沙盒，然后加载本地文件：

• 步骤1：用URLSession下载网页的HTML内容，然后解析HTML中的所有资源链接（图片、CSS、JS），批量下载这些资源到本地指定目录；
• 步骤2：修改HTML中的资源路径，把相对路径改成本地沙盒的绝对路径（或者保留相对路径，加载时指定允许访问的目录）；
• 步骤3：加载本地HTML文件：

  let htmlPath = Bundle.main.path(forResource: "offline_page", ofType: "html")!
  let htmlUrl = URL(fileURLWithPath: htmlPath)
  // 允许访问该目录下的所有资源，解决跨域问题
  let accessUrl = htmlUrl.deletingLastPathComponent()
  webView.loadFileURL(htmlUrl, allowingReadAccessTo: accessUrl)
  

这种方式适合需要固定离线内容的场景，比如帮助页、产品介绍页等，完全不依赖网络，但需要额外处理资源下载和路径替换的逻辑。

重要注意事项 #

• 绝对不要用WKWebViewCache这类库：它会调用私有API，直接导致App审核被拒；
• UIWebView的缓存方案完全不兼容：不要试图把UIWebView的缓存代码迁移到WKWebView，两者的缓存机制完全不同；
• 缓存清理：定期清理过期或无用的缓存，避免占用过多磁盘空间，可以通过WKWebsiteDataStore的removeData(ofTypes:modifiedSince:completionHandler:)方法清理；
• 网络状态判断：离线时一定要切换缓存策略，否则WKWebView会尝试请求网络，导致加载失败。

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