iOS 17下WKWebView代理配置失效问题排查求助

针对你遇到的代理认证弹窗、加载失败（错误域NSPOSIXErrorDomain，错误码80）问题，以下是对应的解答和修复方案：

1. iOS 17中WKWebView的代理配置是否存在已知问题？ #

是的，iOS 17的ProxyConfiguration API在HTTP CONNECT代理的认证处理上存在已知兼容性问题：

• 默认WKWebsiteDataStore的全局共享状态会导致新的代理配置无法正确生效
• 部分场景下，代码传入的凭据无法被正确传递到WKWebView的底层网络栈
• 错误码80对应POSIX的EDESTADDRREQ，通常是代理连接时认证凭据未被识别导致的连接失败

2. 为WKWebView成功配置带认证的代理是否需要额外步骤或配置？ #

需要，以下是必须的额外配置步骤：

• 使用自定义WKWebsiteDataStore：默认共享数据存储会忽略新的代理配置，必须创建独立的数据存储
• 正确构造代理端点：确保NWEndpoint.Host的类型与代理地址匹配（域名用.domain()，IP用.ipv4()/.ipv6()）
• 显式启用代理配置：虽然默认值为true，但显式设置isEnabled可避免潜在的状态异常
• 适配ATS配置：在Info.plist中添加代理服务器和目标URL的ATS例外，确保网络连接被允许
• 指定认证方法：如果代理使用Basic认证，显式设置authenticationMethod可确保凭据按正确格式传递

3. 为何已提供凭据，代理方法仍返回认证错误？ #

核心原因包括：

• 默认WKWebsiteDataStore是全局共享的，新的代理配置无法覆盖原有状态
• 代理端点的类型定义错误（直接传入字符串而非NWEndpoint.Host的正确枚举值）
• 凭据未被正确绑定到代理配置，或者指定的认证方法与代理服务器要求不匹配

修复后的完整代码 #

let webConfiguration = WKWebViewConfiguration()

// 1. 正确构造代理端点：区分域名/IP类型
let proxyHostType: NWEndpoint.Host = .domain(proxyHost) // 若为IP则用 .ipv4(proxyHost)
let proxyPortValue = NWEndpoint.Port(rawValue: UInt16(proxyPort))!
let endpoint = NWEndpoint.hostPort(host: proxyHostType, port: proxyPortValue)

// 2. 创建代理配置并设置凭据、认证方法
let proxyConfig = ProxyConfiguration(httpCONNECTProxy: endpoint)
proxyConfig.isEnabled = true
proxyConfig.applyCredential(username: proxyUsername, password: proxyPassword)
proxyConfig.authenticationMethod = .httpBasic // 若代理用其他认证方式，需对应修改

// 3. 使用自定义非持久化数据存储（也可使用持久化存储：WKWebsiteDataStore(name: "ProxyStore")）
let websiteDataStore = WKWebViewConfiguration().websiteDataStore
websiteDataStore.proxyConfigurations = [proxyConfig]
webConfiguration.websiteDataStore = websiteDataStore

// 4. 初始化WebView并加载请求
let webView = WKWebView(frame: .zero, configuration: webConfiguration)
webView.navigationDelegate = self
view.addSubview(webView)

let request = URLRequest(url: URL(string: "https://whatismyipaddress.com/")!)
webView.load(request)

额外配置：Info.plist的ATS设置 #

添加以下配置，确保代理服务器和目标URL的网络连接被允许：

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <false/>
    <key>NSExceptionDomains</key>
    <dict>
        <key>whatismyipaddress.com</key>
        <dict>
            <key>NSIncludesSubdomains</key>
            <true/>
            <key>NSTemporaryExceptionAllowsInsecureHTTPLoads</key>
            <false/>
        </dict>
        <key>你的代理服务器域名/IP</key>
        <dict>
            <key>NSIncludesSubdomains</key>
            <true/>
            <key>NSTemporaryExceptionAllowsInsecureHTTPLoads</key>
            <false/>
        </dict>
    </dict>
</dict>

其他排查点 #

• 检查代理服务器是否支持HTTP CONNECT方法（针对HTTPS目标URL）
• 确认用户名/密码无特殊字符，若有需先做URL编码
• 测试代理配置是否可通过URLSession正常工作，排除代理服务器本身的问题

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