iOS开发：如何检测当前WiFi需通过验证页面才能访问网络？

嘿，这个场景我之前做项目的时候刚好踩过坑，分享一套靠谱的解决方案给你～

一、先检测是否处于需要验证的WiFi状态 #

iOS系统本身会自动检测 captive portal（也就是需要验证的公共WiFi），我们可以复用苹果的检测逻辑，通过请求苹果的热点检测页面来判断：

检测逻辑 #

向 http://captive.apple.com/hotspot-detect.html 发送一个HEAD请求（比GET更轻量），如果返回的状态码不是200，或者存在Location重定向头，说明当前WiFi需要验证。

Swift代码示例 #

func checkCaptivePortal(completion: @escaping (Bool) -> Void) {
    guard let url = URL(string: "http://captive.apple.com/hotspot-detect.html") else {
        completion(false)
        return
    }
    
    var request = URLRequest(url: url)
    request.httpMethod = "HEAD"
    request.cachePolicy = .reloadIgnoringLocalAndRemoteCacheData // 避免缓存干扰结果
    
    let task = URLSession.shared.dataTask(with: request) { _, response, error in
        if let error = error {
            print("检测请求出错: \(error.localizedDescription)")
            completion(false)
            return
        }
        
        guard let httpResponse = response as? HTTPURLResponse else {
            completion(false)
            return
        }
        
        // 正常状态：200码 + 无重定向头
        let isCaptivePortal = !(httpResponse.statusCode == 200 && httpResponse.allHeaderFields["Location"] == nil)
        completion(isCaptivePortal)
    }
    task.resume()
}

二、用WebView在应用内完成验证 #

当检测到需要验证时，我们可以弹出一个包含WKWebView的页面，加载苹果的检测页面——这个页面会自动重定向到当前WiFi的验证页面，用户在WebView里完成验证后，我们再通过检测逻辑判断是否验证成功，然后关闭WebView。

实现步骤 #

1. 创建一个包含WKWebView的ViewController，用于展示验证页面
2. 监听WebView的导航完成事件，每次页面加载完成后重新检测验证状态
3. 验证成功后关闭WebView

Swift代码示例 #

// 弹出验证WebView的方法
func presentCaptivePortalAuthView() {
    let authVC = UIViewController()
    authVC.title = "WiFi验证"
    
    let webView = WKWebView(frame: authVC.view.bounds)
    webView.autoresizingMask = [.flexibleWidth, .flexibleHeight]
    webView.navigationDelegate = self // 设置导航代理
    
    // 加载苹果检测页，自动跳转到WiFi验证页
    guard let detectUrl = URL(string: "http://captive.apple.com/hotspot-detect.html") else { return }
    webView.load(URLRequest(url: detectUrl))
    
    authVC.view.addSubview(webView)
    present(authVC, animated: true)
}

// 实现WKNavigationDelegate，监听页面加载完成
extension YourViewController: WKNavigationDelegate {
    func webView(_ webView: WKWebView, didFinish navigation: WKNavigation!) {
        // 每次页面加载完成后，重新检测验证状态
        checkCaptivePortal { [weak self] isNeedAuth in
            guard let self = self else { return }
            if !isNeedAuth {
                // 验证成功，关闭WebView页面
                DispatchQueue.main.async {
                    self.dismiss(animated: true)
                }
            }
        }
    }
}

三、一些注意事项 #

• ATS配置：因为苹果的检测页面是HTTP协议，需要在Info.plist里添加ATS例外，允许访问captive.apple.com：

  <key>NSAppTransportSecurity</key>
  <dict>
      <key>NSExceptionDomains</key>
      <dict>
          <key>captive.apple.com</key>
          <dict>
              <key>NSIncludesSubdomains</key>
              <true/>
              <key>NSTemporaryExceptionAllowsInsecureHTTPLoads</key>
              <true/>
          </dict>
      </dict>
  </dict>
  

• 网络状态监听：可以配合Reachability库监听网络状态变化，一旦切换到WiFi就自动触发检测，提升用户体验
• 用户体验优化：可以在WebView里添加一个“取消”按钮，让用户可以随时关闭验证页面；另外，验证过程中可以显示加载状态，避免用户困惑

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