iOS端WebView场景使用HTTPDNS

1. 前言

通过iOS端Native场景使用HTTPDNS这篇文档，我们已经知道如何在iOS平台上的Native场景中如何使用HTTPDNS，实现防劫持、调度精准、解析及时生效的能力。

而iOS上还有一个频繁发生网络请求的场景：WkWebView。WKWebView是WebKit框架提供的一个现代Web视图，用于在iOS应用中显示网页内容。它替代了旧的UIWebView，提供了更好的性能、更多的功能和更高的安全性。我们期望，在WkWebView加载网页的时候，也能使用HTTPDNS，提升网络安全性与网络性能。

2. 技术现状

随着iOS系统的不断发展，WKWebView集成HTTPDNS的技术方案也在持续演进：

• iOS 17.0之前：Apple官方并未在WkWebView上开放DNS解析相关的hook接口，也并未直接开放自定义网络请求实现的接口，需要通过hook 私有API拦截流量的复杂方案实现。

• iOS 17.0及以后：Apple引入了ProxyConfiguration相关API，为WKWebView提供了官方的代理配置能力，可以通过“接近完美”的方式拦截所有网络请求，使得优雅集成HTTPDNS成为可能。

根据Apple官方统计数据（截至2025年6月4日），在系统版本分布上，iOS 17+已经占全部iPhone设备的85%以上，且在持续增长中。因此，考虑到HTTPDNS为WkWebView场景带来的是防劫持、调度精准、解析及时生效等非功能性提升，建议直接通过本方案接入HTTPDNS，覆盖大部分客户，且旧版本系统用户，也会在后续的陆续版本升级中，逐渐享受这个能力。

3. 推荐方案：iOS 17+基于本地代理的方案

source 'https://github.com/aliyun/aliyun-specs.git'

target 'yourAppTarget' do
    use_framework!
    
    pod 'AlicloudHTTPDNS', 'x.x.x'
    pod 'EMASLocalProxy', 'x.x.x'
end

#import <EMASLocalProxy/EMASLocalProxy.h>
#import <AlicloudHttpDNS/AlicloudHttpDNS.h>

// 创建 WKWebViewConfiguration
WKWebViewConfiguration *config = [[WKWebViewConfiguration alloc] init];

// 配置DNS解析器
[EMASLocalHttpProxy setDNSResolverBlock:^NSArray<NSString *> *(NSString *hostname) {
    // 获取HTTPDNS服务实例
    HttpDnsService *httpdns = [HttpDnsService sharedInstance];
    HttpdnsResult *result = [httpdns resolveHostSyncNonBlocking:hostname byIpType:HttpdnsQueryIPTypeBoth];

    if (result && (result.hasIpv4Address || result.hasIpv6Address)) {
        NSMutableArray<NSString *> *allIPs = [NSMutableArray array];
        if (result.hasIpv4Address) {
            [allIPs addObjectsFromArray:result.ips];
        }
        if (result.hasIpv6Address) {
            [allIPs addObjectsFromArray:result.ipv6s];
        }
        NSLog(@"HTTPDNS解析成功，域名: %@, IP: %@", hostname, allIPs);
        return allIPs;
    }

    NSLog(@"HTTPDNS解析失败，域名: %@", hostname);
    return nil;
}];

// 设置日志级别
[EMASLocalHttpProxy setLogLevel:EMASLocalHttpProxyLogLevelDebug];

// 配置WebView代理
BOOL proxyConfigured = [EMASLocalHttpProxy installIntoWkWebViewConfiguration:config];
if (proxyConfigured) {
    NSLog(@"WebView代理配置成功");
} else {
    NSLog(@"WebView代理配置失败，使用系统网络");
}

WKWebView *webView = [[WKWebView alloc] initWithFrame:self.view.bounds configuration:config];

4. 自定义WKURLSchemeHandler的方案

EMAS目前提供了一个实验性质的参考方案：EMASCurlWeb，该方案在Github上开源，可以考虑参考这个方案，自行结合业务需要，实现一个托管WkWebView网络请求的完整方案。在此基础上，还可以根据业务需要，进一步实现资源预取、自定义缓存等能力。

5. 全局拦截NSURLProtocol的方案

本方案是最早在iOS WebView上适配HTTPDNS的可行方案，它接入门槛实际上很高，效果也不好，只不过早年iOS并未提供其他选择，因此流传下来。它的原理是，基于NSURLProtocol可拦截iOS系统上基于上层网络库NSURLConnection/NSURLSession发出的网络请求，WkWebView发出的请求同样包含在内，拦截请求后，再使用HTTPDNS做域名解析和后续处理。步骤如下：

1. 通过以下接口注册自定义NSURLProtocol，用于拦截WkWebView上层网络请求，并创建新的网络请求接管数据发送、接收、重定向等处理逻辑，将结果反馈给原始请求。

   [NSURLProtocol registerClass:[HttpDnsNSURLProtocolImpl class]];

2. 自定义NSURLProtocol处理过程概述：

   • 在canInitWithRequest中过滤需要做HTTPDNS域名解析的请求。

   • 请求拦截后，做HTTPDNS域名解析。

   • 解析完成后，同普通请求一样，替换URL.host字段，替换HTTP Header Host域，并接管该请求的数据发送、接收、重定向等处理。

   • 通过NSURLProtocol的接口，将请求处理结果反馈到WebView原始请求。

3. 自定义NSURLProtocol的实现逻辑可参考我们提供的demo中的 HttpDnsNSURLProtocolImpl.m。

6. 方案总结与对比

本文档介绍了在iOS端WKWebView场景下集成HTTPDNS的三种主要技术方案：基于iOS 17+的本地代理方案、自定义WKURLSchemeHandler方案以及全局拦截NSURLProtocol的方案。

每种方案都有其特定的适用场景、优缺点和实现复杂度。为帮助您快速决策，下表对这三种方案进行了横向对比：

综合考虑稳定性、开发维护成本和未来趋势，我们强烈推荐使用基于iOS 17+的本地代理方案。

随着iOS 17+系统版本的高速普及，该方案能以最低的成本为绝大多数用户带来稳定、可靠的HTTPDNS服务，有效解决域名劫持问题，并提升网络性能。其优雅的实现方式和官方支持，确保了方案的长期可行性。对于低于iOS 17的系统版本，采取平滑降级策略，即直接使用系统默认的网络请求，待用户升级系统后自动享受HTTPDNS带来的优势。

其他两种方案由于其固有的复杂性和不确定性，仅建议在有特殊需求且具备深厚技术储备的团队，经过充分评估和测试后谨慎采用。