You need to enable JavaScript to run this app. iOS Swift中如何检测已连接网络的外部访问可达性?
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.16 07:15:04