iOS Swift中如何检测已连接网络的外部访问可达性?
适配iOS12+的业务服务器可达性检测方案
核心实现逻辑
针对连接IoT内网热点时需要验证远端业务服务器可达性的场景,优先使用苹果原生Network框架实现,iOS12及以上全版本原生支持,无需引入第三方依赖:
- 不要使用通用全局网络连通性检测接口,需针对实际要上传数据的业务服务器创建专属检测实例,避免系统误判内网连通等同于公网可达
- 基于目标服务器的域名/IP+端口创建
NWEndpoint,再初始化NWPathMonitor做针对性检测 - 检测到远端服务器不可达时,可根据系统版本执行自动切换WiFi或引导用户手动切换的逻辑
代码示例
import Network import NetworkExtension import UIKit // 替换为实际使用的业务上传服务器地址与端口 let targetServer = NWEndpoint.hostPort( host: "your-business-server.com", port: .init(integerLiteral: 443) ) // 初始化专属路径监视器 let reachabilityMonitor = NWPathMonitor(endpoint: targetServer) // 启动监视器,指定后台队列避免阻塞主线程 reachabilityMonitor.start(queue: DispatchQueue(label: "com.yourapp.reachability")) reachabilityMonitor.pathUpdateHandler = { updatedPath in DispatchQueue.main.async { if updatedPath.status == .satisfied { // 远端服务器可达,正常执行数据上传逻辑 } else { // 远端服务器不可达,执行网络切换逻辑 if #available(iOS 14.0, *) { // 替换为要切换的本地WiFi的SSID与密码 let wifiConfig = NEHotspotConfiguration( ssid: "target-local-wifi-ssid", passphrase: "wifi-password", isWEP: false ) wifiConfig.joinOnce = true // 仅本次连接,后续可根据需求调整 NEHotspotConfigurationManager.shared.apply(wifiConfig) { error in if error != nil { // 切换失败,可提示用户手动切换 } } } else { // iOS12/13版本引导用户跳转系统设置页切换WiFi guard let settingUrl = URL(string: UIApplication.openSettingsURLString) else { return } UIApplication.shared.open(settingUrl) } } } }
注意事项
- 需要在Xcode的
Signing & Capabilities中添加Hotspot Configuration权限,才能实现自动切换WiFi的能力 - 不要使用ping公共域名的方案做检测,若业务服务器单独出现故障时会产生误判,必须针对实际要访问的业务地址做检测
- 若需要同时检测多个不同的业务服务器,可为每个服务器分别创建独立的
NWPathMonitor实例,也可以发起轻量HEAD请求到对应服务器的健康检查接口验证可达性,HEAD请求资源开销极低,不会产生额外的流量负担 - 若项目使用Objective-C开发,可通过OC-Swift桥接调用上述代码,也可以使用旧版
SCNetworkReachabilityAPI针对指定域名做检测,该API在iOS12上可正常运行,仅被苹果标记为待废弃状态
内容的提问来源于stack exchange,提问作者prakash546
相关产品推荐
相关产品推荐

