萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 網路安全 >  >> 網路基礎知識

iOS/macOS 網絡可達性快速檢測:SCNetworkReachability 實戰代碼片段

在 iOS/macOS 應用開發中,發起網絡請求前快速判斷「當前是否有可用的互聯網路徑」是優化用戶體驗、避免無效請求阻塞主線程的關鍵。Apple 提供 SCNetworkReachability API(SystemConfiguration 框架)實現零依賴、低開銷的網絡狀態監聽。以下為生產級 Swift/Objective-C 封裝方案。

核心原理

  • 創建一個「零地址」sockaddr_in(sin_family=AF_INET,其餘為 0),代表「默認路由/網關」方向。
  • 調用 SCNetworkReachabilityCreateWithAddress(NULL, &zeroAddress) 獲得引用。
  • 調用 SCNetworkReachabilityGetFlags 獲取旗標:
    • kSCNetworkFlagsReachable:目標可達(有路由)。
    • kSCNetworkFlagsConnectionRequired:需要主動發起連接(如撥號、VPN 按需撥號)。
  • 判斷邏輯:isReachable && !needsConnection 即為「當前可直接訪問互聯網」。

Swift 5 現代化封裝(Combine/async-await 就緒)

import SystemConfiguration
import Combine

final class NetworkReachability {
    static let shared = NetworkReachability()
    private let reachability: SCNetworkReachability
    private let subject = CurrentValueSubject<Bool, Never>(false)
    var publisher: AnyPublisher<Bool, Never> { subject.eraseToAnyPublisher() }

    private init() {
        var zero = sockaddr_in()
        zero.sin_len = UInt8(MemoryLayout.size(ofValue: zero))
        zero.sin_family = sa_family_t(AF_INET)
        reachability = SCNetworkReachabilityCreateWithAddress(nil, &zero)!
        startMonitoring()
    }

    private func startMonitoring() {
        var context = SCNetworkReachabilityContext(version: 0, info: Unmanaged.passUnretained(self).toOpaque(), retain: nil, release: nil, copyDescription: nil)
        SCNetworkReachabilitySetCallback(reachability, { _, flags, info in
            guard let info = info else { return }
            let myself = Unmanaged<NetworkReachability>.fromOpaque(info).takeUnretainedValue()
            let reachable = flags.contains(.reachable)
            let needsConn = flags.contains(.connectionRequired)
            myself.subject.send(reachable && !needsConn)
        }, &context)
        SCNetworkReachabilityScheduleWithRunLoop(reachability, CFRunLoopGetMain(), CFRunLoopMode.commonModes.rawValue)
    }

    // 同步檢查(適用啟動頁/離線快取判斷)
    func isConnected() -> Bool {
        var flags = SCNetworkReachabilityFlags()
        guard SCNetworkReachabilityGetFlags(reachability, &flags) else { return false }
        return flags.contains(.reachable) && !flags.contains(.connectionRequired)
    }
}

// 使用示例
// NetworkReachability.shared.publisher.sink { online in print("網絡狀態:", online ? "在線" : "離線") }.store(in: &cancellables)
// if NetworkReachability.shared.isConnected() { /* 發起請求 */ } else { /* 顯示離線提示/啟用離線模式 */ }

Objective-C 經典實現(參考原文片段優化)

- (BOOL)connectedToNetwork {
    struct sockaddr_in zeroAddress;
    bzero(&zeroAddress, sizeof(zeroAddress));
    zeroAddress.sin_len = sizeof(zeroAddress);
    zeroAddress.sin_family = AF_INET;

    SCNetworkReachabilityRef ref = SCNetworkReachabilityCreateWithAddress(NULL, (struct sockaddr *)&zeroAddress);
    SCNetworkReachabilityFlags flags;
    BOOL gotFlags = SCNetworkReachabilityGetFlags(ref, &flags);
    CFRelease(ref);
    if (!gotFlags) return NO;
    return (flags & kSCNetworkFlagsReachable) && !(flags & kSCNetworkFlagsConnectionRequired);
}

// 呼叫示例
- (void)start {
    if (![self connectedToNetwork]) {
        UIAlertController *alert = [UIAlertController alertControllerWithTitle:@"網絡連接錯誤"
                                                                       message:@"請檢查網絡設置後重試"
                                                                preferredStyle:UIAlertControllerStyleAlert];
        [alert addAction:[UIAlertAction actionWithTitle:@"確定" style:UIAlertActionStyleDefault handler:nil]];
        [self presentViewController:alert animated:YES completion:nil];
    } else {
        // 執行網絡請求
    }
}

最佳實踐建議

  1. 不要阻塞主線程: 異步監聽(回調/Combine/AsyncSequence)更新 UI 狀態,同步檢查僅用於啟動決策。
  2. 區分「可達」與「有 Internet」: 可達僅意味著有路由到達網關;真正的 Internet 連通性需實際發起 HTTP/HTTPS 請求驗證(如請求 https://captive.apple.com 或 https://www.google.com/generate_204)。
  3. 處理 Captive Portal: 熱點登錄頁會導致 kSCNetworkFlagsConnectionRequired 為真,需引導用戶打開瀏覽器認證。
  4. 配合 NWPathMonitor (iOS 12+): 新框架支援路徑級監測(Wi-Fi/蜂窩/以太網獨立狀態)、IPv6、貴重數據模式,建議新項目優先使用。

合理運用網絡可達性檢測,能顯著減少無效請求、優化離線體驗、精準引導用戶操作,是成熟移動應用的必備質量指標。

copyright © 萬盛學電腦網 all rights reserved