iOS下NEHotspotConfiguration连接Wi-Fi：错密码后正确密码仍失败

问题场景 #

在iOS应用中使用NEHotspotConfiguration编程连接Wi-Fi时，首次用错误密码连接会正常返回错误提示“Failed to connect: Not associated with the expected SSID.”；但后续更换正确密码重试时，仍弹出相同错误，无法成功建立连接。

原代码示例 #

func connectToWiFi(ssid: String, password: String, joinOnce: Bool, completion: @escaping (Bool, String) -> Void) {
       
        // First, remove any existing configuration for the SSID to avoid caching issues
        NEHotspotConfigurationManager.shared.removeConfiguration(forSSID: ssid)

        DispatchQueue.main.asyncAfter(deadline: .now() + 1.0) {
            
            let hotspotConfiguration = NEHotspotConfiguration(ssid: ssid, passphrase: password, isWEP: false)
            hotspotConfiguration.joinOnce = joinOnce
            
            NEHotspotConfigurationManager.shared.apply(hotspotConfiguration) { error in
                if let error = error {
                    if (error as NSError).code == NEHotspotConfigurationError.alreadyAssociated.rawValue {
                        print("Already connected to the Wi-Fi: \(ssid)")
                        completion(true,"Already connected to the Wi-Fi: \(ssid)")
                    } else {
                        print("Failed to connect to Wi-Fi: \(ssid), Error: \(error.localizedDescription)")
                        completion(false, "Failed to connect to Wi-Fi: \(ssid), Error: \(error.localizedDescription)")
                    }
                } else {
                    print(WiFiSSIDManager.shared.currentSSIDs())
                    if WiFiSSIDManager.shared.currentSSIDs().first == ssid {
                        // Real success
                        completion(true, "Successfully connected to Wi-Fi: \(ssid)")
                    } else {
                        // Failure
                        completion(false, "Failed to connect: Not associated with the expected SSID.")
                    }
                }
            }
        }
    }

  func currentSSIDs() -> [String] {
        var ssid: [String] = []
                if let interfaces = CNCopySupportedInterfaces() as NSArray? {
                    for interface in interfaces {
                        if let interfaceInfo = CNCopyCurrentNetworkInfo(interface as! CFString) as NSDictionary? {
                            if let currentSSID = interfaceInfo[kCNNetworkInfoKeySSID as String] as? String {
                                ssid.append(currentSSID)
                            }
                        }
                    }
                }
                return ssid
    }

解决方法与优化步骤 #

1. 确保配置清除操作完成后再执行新请求 #

原代码用固定1秒延迟等待配置清除，这不可靠。应使用带完成回调的removeConfiguration(forSSID:completionHandler:)，确保清除操作完成后再创建新配置，避免时序冲突。

2. 处理系统Wi-Fi凭证缓存 #

iOS会自动缓存Wi-Fi连接凭证，即使移除了NEHotspotConfiguration，系统仍可能保留错误的密码缓存。可以：

• 若设备当前已关联该SSID，依赖系统自动断开逻辑（编程层面无法直接强制断开）
• 若joinOnce设为true，系统不会持久化配置，但仍需确保之前的错误缓存被清除

3. 优化连接后的SSID校验逻辑 #

原代码在apply完成后立即检查当前SSID，此时系统可能还在建立连接过程中，导致误判。建议增加短延迟后再校验，提升准确性。

4. 极端情况的重置方案 #

如果上述方法无效，可尝试调用NEHotspotConfigurationManager.shared.removeAllConfigurations()清除所有应用配置的Wi-Fi（注意：会影响其他已配置的网络，需谨慎使用）；若仍无法解决，只能引导用户手动在系统设置中“忽略此网络”，编程层面无法直接触发该操作。

优化后的代码示例 #

func connectToWiFi(ssid: String, password: String, joinOnce: Bool, completion: @escaping (Bool, String) -> Void) {
    // 使用带回调的移除方法，确保清除完成后再执行下一步
    NEHotspotConfigurationManager.shared.removeConfiguration(forSSID: ssid) { [weak self] removeError in
        if let removeError = removeError {
            print("清除\(ssid)旧配置失败: \(removeError.localizedDescription)")
        }
        
        // 创建新的Wi-Fi配置
        let hotspotConfig = NEHotspotConfiguration(ssid: ssid, passphrase: password, isWEP: false)
        hotspotConfig.joinOnce = joinOnce
        
        // 应用新配置
        NEHotspotConfigurationManager.shared.apply(hotspotConfig) { applyError in
            if let applyError = applyError {
                if (applyError as NSError).code == NEHotspotConfigurationError.alreadyAssociated.rawValue {
                    completion(true, "已连接到Wi-Fi: \(ssid)")
                } else {
                    completion(false, "连接Wi-Fi失败: \(ssid)，错误：\(applyError.localizedDescription)")
                }
                return
            }
            
            // 延迟检查当前SSID，避免连接未完成导致误判
            DispatchQueue.main.asyncAfter(deadline: .now() + 0.8) {
                let currentSSIDs = self?.currentSSIDs() ?? []
                if currentSSIDs.contains(ssid) {
                    completion(true, "成功连接到Wi-Fi: \(ssid)")
                } else {
                    completion(false, "连接失败：未关联到预期的SSID。")
                }
            }
        }
    }
}

func currentSSIDs() -> [String] {
    var ssidList: [String] = []
    guard let interfaces = CNCopySupportedInterfaces() as NSArray? else { return ssidList }
    
    for interface in interfaces {
        guard let interfaceInfo = CNCopyCurrentNetworkInfo(interface as! CFString) as NSDictionary?,
              let currentSSID = interfaceInfo[kCNNetworkInfoKeySSID as String] as? String else { continue }
        ssidList.append(currentSSID)
    }
    return ssidList
}

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