WKWebView自定义URL Scheme在HTTPS下失效？混合内容被拦截如何解决？

这问题我之前做项目时刚好踩过坑！核心原因就是Safari的混合内容安全策略在搞事情：当页面运行在HTTPS这种安全上下文里时，默认会阻止所有被判定为“不安全”的请求，你的mycustomurl:// Scheme刚好被归到了这一类，所以直接被拦截，连WKURLSchemeHandler的回调都没机会触发。

下面是我亲测有效的解决步骤，按顺序来：

1. 给HTTPS页面配置正确的内容安全策略（CSP） #

不管是通过服务器响应头还是页面内的meta标签，都需要明确允许你的自定义Scheme。这是让浏览器知道“这个Scheme是我认可的安全内容”的关键。

• 方式一：页面meta标签
  在网站的HTML头部添加：

<meta http-equiv="Content-Security-Policy" content="default-src 'self' mycustomurl:; connect-src mycustomurl:;">

解释下：default-src覆盖大部分资源请求，connect-src专门针对JS发起的fetch、XMLHttpRequest这类请求，如果你的网站是通过JS调用Scheme，这个规则不能少。

• 方式二：服务器响应头
  在HTTPS接口的响应里添加：

Content-Security-Policy: default-src 'self' mycustomurl:; connect-src mycustomurl:;

这种方式比meta标签优先级更高，适合全局管控。

2. 配置WKWebView的混合内容允许策略 #

iOS 13及以上，WKWebView提供了明确的混合内容控制开关，需要把它设置为允许加载混合内容：

// 创建配置对象
let configuration = WKWebViewConfiguration()

// 注册你的自定义Scheme Handler
configuration.setURLSchemeHandler(self, forURLScheme: "mycustomurl")

// 配置混合内容模式
let webpagePrefs = WKWebpagePreferences()
// .alwaysAllow 允许所有混合内容；.compatibility 仅允许被动加载的内容（比如图片），根据你的需求选
webpagePrefs.mixedContentMode = .alwaysAllow
configuration.defaultWebpagePreferences = webpagePrefs

// 初始化WebView
let webView = WKWebView(frame: view.bounds, configuration: configuration)

如果是iOS 12及以下，需要通过KVC设置偏好：

configuration.preferences.setValue(true, forKey: "allowUniversalAccessFromFileURLs")
configuration.preferences.setValue(true, forKey: "allowFileAccessFromFileURLs")

3. 验证Scheme注册是否正确 #

确保你已经在WKURLSchemeHandler的实现里正确处理了请求，比如：

func webView(_ webView: WKWebView, start urlSchemeTask: WKURLSchemeTask) {
    guard let url = urlSchemeTask.request.url else { return }
    // 这里处理你的mycustomurl请求逻辑
    print("收到自定义Scheme请求：\(url)")
    // 记得完成任务，比如发送响应
    let response = HTTPURLResponse(url: url, statusCode: 200, httpVersion: nil, headerFields: nil)!
    urlSchemeTask.didReceive(response)
    urlSchemeTask.didFinish()
}

最后排查点 #

• 如果是通过<a>标签跳转，确保标签没有被JS阻止，或者添加target="_self"试试；
• 检查是否有其他安全插件或者浏览器扩展（如果是Mac端）干扰了请求；
• 用Safari的Web Inspector查看控制台，除了拦截提示外，是否有其他CSP报错，根据报错调整规则。

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