在 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 即為「當前可直接訪問互聯網」。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 { /* 顯示離線提示/啟用離線模式 */ }
- (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 {
// 執行網絡請求
}
}
https://captive.apple.com 或 https://www.google.com/generate_204)。kSCNetworkFlagsConnectionRequired 為真,需引導用戶打開瀏覽器認證。合理運用網絡可達性檢測,能顯著減少無效請求、優化離線體驗、精準引導用戶操作,是成熟移動應用的必備質量指標。