Swift：如何拦截WKWebView外部资源请求并替换为本地打包资源？

一、用WKNavigationDelegate拦截资源请求（推荐） #

WKWebView不允许直接给http/https绑定自定义Scheme处理器，但可以通过WKNavigationDelegate的拦截逻辑实现本地资源替换，步骤如下：

1. 实现decidePolicyForNavigationAction:方法，判断当前请求的资源是否存在于本地包内：

   - (void)webView:(WKWebView *)webView decidePolicyForNavigationAction:(WKNavigationAction *)navigationAction decisionHandler:(void (^)(WKNavigationPolicy))decisionHandler {
       NSURL *requestURL = navigationAction.request.URL;
       // 只拦截指定域名的资源请求
       if ([requestURL.host isEqualToString:@"your-cdn-domain.com"]) {
           // 提取线上资源的相对路径，拼接成本地包路径
           NSString *localPath = [[NSBundle mainBundle] pathForResource:requestURL.path.stringByRemovingPercentEncoding ofType:nil];
           if (localPath) {
               // 取消原请求，加载本地资源
               decisionHandler(WKNavigationPolicyCancel);
               NSURL *localFileURL = [NSURL fileURLWithPath:localPath];
               [webView loadFileURL:localFileURL allowingReadAccessToURL:[[NSBundle mainBundle] bundleURL]];
               return;
           }
       }
       // 本地无对应资源，允许正常请求
       decisionHandler(WKNavigationPolicyAllow);
   }
   

2. 注意保持资源的相对路径一致性：本地资源的目录结构要和线上完全对齐，避免CSS/JS里的相对路径引用失效。

二、修复自定义Scheme处理器的问题 #

如果坚持使用自定义Scheme（如external://），针对现有问题逐一解决：

• 性能优化：避免同步读取本地文件，改用异步IO，同时对高频资源做内存缓存：

  - (void)startURLSchemeTask:(id<WKURLSchemeTask>)task {
      NSURL *url = task.request.URL;
      NSString *localPath = [[NSBundle mainBundle] pathForResource:url.path.stringByRemovingPercentEncoding ofType:nil];
      if (!localPath) {
          [task didFailWithError:[NSError errorWithDomain:@"LocalResourceError" code:-1 userInfo:@{NSLocalizedDescriptionKey:@"Resource not found"}]];
          return;
      }
      // 异步读取文件
      dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{
          NSData *data = [NSData dataWithContentsOfFile:localPath];
          NSString *mimeType = [self mimeTypeForFileExtension:url.pathExtension];
          NSURLResponse *response = [[NSURLResponse alloc] initWithURL:url MIMEType:mimeType expectedContentLength:data.length textEncodingName:nil];
          dispatch_async(dispatch_get_main_queue(), ^{
              [task didReceiveResponse:response];
              [task didReceiveData:data];
              [task didFinish];
          });
      });
  }
  

• MIME类型正确映射：给不同扩展名的资源配置正确的MIME类型，比如.css对应text/css，.png对应image/png，否则WebView无法正确解析资源。
• 验证生效状态：
  • 给处理器添加日志，打印每个请求的URL和本地资源路径，确认是否命中本地文件；
  • 用Safari远程调试WKWebView，查看网络请求面板，检查资源的请求URL、状态码和响应来源。

三、从根源减少服务器请求 #

• 预替换Web页面资源地址：在打包iOS应用时，批量替换Web代码里的外部资源URL为自定义Scheme或本地路径，比如把https://cdn.example.com/css/main.css替换成local://css/main.css，避免WebView发起不必要的外部请求。
• 完整打包所有依赖资源：确保所有需要离线加载的资源都已包含在应用包内，避免出现本地缺失导致的回退请求。

四、调试技巧 #

• Safari远程调试：将iOS设备连接到Mac，打开Safari的「开发」菜单，选择对应设备上的WKWebView，在「网络」面板查看资源加载详情，确认本地资源是否成功加载。
• 耗时监控：在资源读取和响应的关键节点添加时间戳日志，定位性能瓶颈（比如文件读取耗时过长）。

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