如何在Swift中创建HTTP请求的本地覆盖？以及如何重现WKWebView Inspector的本地覆盖读写功能？

刚好我之前研究过这两个问题，给你梳理下可行的方案：

一、Swift开发环境中创建HTTP请求的本地覆盖 #

最常用且灵活的方式是利用URLProtocol来拦截全局的HTTP/HTTPS请求，然后返回本地预设的响应内容，完全不需要修改原有请求代码。具体步骤如下：

1. 自定义URLProtocol子类 #

创建一个继承自URLProtocol的类，负责处理拦截逻辑：

import Foundation

class LocalOverrideURLProtocol: URLProtocol {
    // 匹配需要拦截的请求
    override class func canInit(with request: URLRequest) -> Bool {
        // 这里可以自定义规则，比如特定域名、路径，或者仅在调试环境启用
        guard let url = request.url, url.host == "api.example.com" else {
            return false
        }
        return true
    }

    override class func canonicalRequest(for request: URLRequest) -> URLRequest {
        return request
    }

    override func startLoading() {
        guard let client = client else { return }
        
        // 构造本地响应内容（可替换为本地文件读取逻辑）
        let localData = "{\"status\": \"success\", \"data\": \"local override content\"}".data(using: .utf8)
        let response = HTTPURLResponse(
            url: request.url!,
            statusCode: 200,
            httpVersion: "HTTP/1.1",
            headerFields: ["Content-Type": "application/json"]
        )!
        
        // 发送响应和数据
        client.urlProtocol(self, didReceive: response, cacheStoragePolicy: .notAllowed)
        if let data = localData {
            client.urlProtocol(self, didLoad: data)
        }
        client.urlProtocolDidFinishLoading(self)
    }

    override func stopLoading() {
        // 清理资源（如果有异步操作需要取消）
    }
}

2. 注册自定义Protocol #

在App启动时（比如AppDelegate的启动方法或SceneDelegate的连接方法）注册这个Protocol：

#if DEBUG
// 仅在调试环境启用，避免影响生产
URLProtocol.registerClass(LocalOverrideURLProtocol.self)
#endif

二、重现WKWebView Inspector的Local Overrides功能并实现读写 #

WKWebView Inspector的本地覆盖是Safari开发者工具提供的调试功能，如果要自己实现类似逻辑，或者读写已有的覆盖规则，有两种思路：

1. 自行实现本地覆盖逻辑（推荐） #

通过WKURLSchemeHandler拦截WebView的请求，自定义响应内容，同时可以将覆盖规则存储在本地，方便读写：

步骤1：自定义Scheme Handler

import WebKit

class LocalOverrideSchemeHandler: NSObject, WKURLSchemeHandler {
    // 存储覆盖规则：URL字符串 -> 本地文件路径
    var overrideRules: [String: String] = [:]

    func webView(_ webView: WKWebView, start urlSchemeTask: WKURLSchemeTask) {
        guard let url = urlSchemeTask.request.url,
              let localFilePath = overrideRules[url.absoluteString],
              let data = try? Data(contentsOf: URL(fileURLWithPath: localFilePath)) else {
            // 无覆盖规则时，可选择返回错误或放行（需额外处理）
            urlSchemeTask.didFailWithError(NSError(domain: "LocalOverride", code: -1, userInfo: [NSLocalizedDescriptionKey: "No override found"]))
            return
        }

        // 根据本地文件类型调整Content-Type
        let response = HTTPURLResponse(
            url: url,
            statusCode: 200,
            httpVersion: "HTTP/1.1",
            headerFields: ["Content-Type": "text/html"]
        )!
        
        urlSchemeTask.didReceive(response)
        urlSchemeTask.didReceive(data)
        urlSchemeTask.didFinish()
    }

    func webView(_ webView: WKWebView, stop urlSchemeTask: WKURLSchemeTask) {
        // 清理资源（如取消文件读取任务）
    }
}

步骤2：配置WKWebView并注册Handler

let handler = LocalOverrideSchemeHandler()
let configuration = WKWebViewConfiguration()
// 拦截HTTPS请求，如需拦截HTTP可添加对应scheme
configuration.setURLSchemeHandler(handler, forURLScheme: "https")

let webView = WKWebView(frame: .zero, configuration: configuration)

步骤3：读写覆盖规则

可以将规则持久化到UserDefaults或本地JSON文件：

// 写入覆盖规则
func saveOverrideRule(for url: String, localPath: String) {
    handler.overrideRules[url] = localPath
    UserDefaults.standard.set(handler.overrideRules, forKey: "LocalOverrideRules")
}

// 加载已保存的规则
func loadOverrideRules() {
    if let rules = UserDefaults.standard.dictionary(forKey: "LocalOverrideRules") as? [String: String] {
        handler.overrideRules = rules
    }
}

2. 读写Safari已有的Local Overrides（仅调试场景） #

Safari的本地覆盖规则存储在未公开的用户沙盒目录中（路径可能随系统版本变化）：

~/Library/Containers/com.apple.Safari/Data/Library/Safari/LocalOverrides/

该目录下的JSON文件保存了覆盖的URL、本地文件路径等信息。你可以通过Swift代码读取这些文件，但注意：

• 这是未公开的路径，苹果可能在未来版本中修改
• 仅适合调试工具类应用，不建议在生产App中使用

示例读取代码：

func readSafariLocalOverrides() {
    guard let containerURL = FileManager.default.containerURL(forSecurityApplicationGroupIdentifier: "com.apple.Safari")?.appendingPathComponent("Library/Safari/LocalOverrides") else {
        print("无法访问Safari Local Overrides目录")
        return
    }
    
    do {
        let files = try FileManager.default.contentsOfDirectory(at: containerURL, includingPropertiesForKeys: nil)
        for file in files where file.pathExtension == "json" {
            let data = try Data(contentsOf: file)
            if let json = try JSONSerialization.jsonObject(with: data) as? [String: Any] {
                print("覆盖规则：\(json)")
            }
        }
    } catch {
        print("读取失败：\(error)")
    }
}

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