Android设备使用WifiNetworkSuggestion与WifiNetworkSpecifier无法连接WiFi的问题求助

阿华AIGC实验室

2026-4-2

哎，我看了你的代码和问题描述，发现几个很可能导致失败的核心问题，先给你指出来，你可以先按这些点修改后再测试：

1. 最关键的错误：SSID和密码的字符串模板写法完全错了！

你看你两段代码里都写了这种错误的模板：

.setSsid("$wifiDetails?.ssid")
.setWpa2Passphrase("$wifiDetails?.password")

这种写法会把整个表达式的字面量当成字符串内容，比如如果wifiDetails的SSID是MyHomeWiFi，最终生成的字符串会是MyHomeWiFi?.ssid，这根本不是正确的WiFi名称！如果wifiDetails是null的话，还会变成null?.ssid，完全是无效的SSID，这直接导致了STATUS_NETWORK_SUGGESTIONS_ERROR_ADD_INVALID错误！

正确的写法应该是先判空，再直接引用非空的SSID和密码：

// 先判空，避免空指针和无效参数
wifiDetails ?: run {
    showToast("WiFi信息为空，无法连接")
    return
}

// 用非空的ssid和密码构建建议
val suggestedWifi = WifiNetworkSuggestion.Builder()
    .setSsid(wifiDetails.ssid)
    .setWpa2Passphrase(wifiDetails.password)
    .setPriority(1000) // 用合理的优先级范围，不用设到999999
    .build()

WifiNetworkSpecifier的代码里也要同步改这个问题，把"$wifiDetails?.ssid"换成wifiDetails.ssid，先判空再操作。

2. 关于WifiNetworkSuggestion的其他注意点

你设置的优先级999999太极端了，虽然数值越大优先级越高，但系统对优先级有隐性的合理范围（比如1-1000），改成合理数值避免潜在的系统判定问题。
确认你连接的WiFi加密方式是WPA2，如果是WPA3，要换成setWpa3Passphrase方法，用错加密类型也会导致添加建议失败。
虽然你在Manifest里加了NEARBY_WIFI_DEVICES权限，但Android 12+的部分厂商设备可能需要你在代码里主动请求这个权限（它是正常权限，不需要弹窗，调用requestPermissions即可）。

3. 优化WifiNetworkSpecifier的调试逻辑

你当前的NetworkCallback只重写了onAvailable，根本看不到连接失败的具体原因，建议补充其他回调来定位问题：

val networkCallback = object : ConnectivityManager.NetworkCallback() {
    override fun onAvailable(network: Network) {
        super.onAvailable(network)
        val success = connectivityManager.bindProcessToNetwork(network)
        if (success) {
            Log.d("MainActivity", "成功绑定到WiFi网络")
            showToast("WiFi连接成功！")
        } else {
            Log.e("MainActivity", "绑定网络失败")
        }
    }

    override fun onUnavailable() {
        super.onUnavailable()
        Log.e("MainActivity", "连接失败：WiFi不可用（可能是密码错误/SSID不存在）")
        showToast("WiFi连接失败：网络不可用")
    }

    override fun onLost(network: Network) {
        super.onLost(network)
        Log.d("MainActivity", "WiFi连接已断开")
        showToast("WiFi连接已断开")
    }
}

另外，记得在页面销毁或者不需要连接时调用connectivityManager.unregisterNetworkCallback(networkCallback)，避免内存泄漏。