Flutter WiFi连接插件在Android 6.0报ClassNotFoundException求助

这个问题我之前也碰到过，核心原因非常明确：WifiNetworkSpecifier是Android 10（API level 29）才新增的系统API，而Android 6.0（API 23）的系统里完全不存在这个类。你现在的代码在没有做API版本前置判断的情况下，就直接初始化了WifiNetworkSpecifier.Builder——这会导致低版本系统在加载类的时候直接触发ClassNotFoundException，根本走不到后面的API版本判断逻辑。

解决思路 #

我们需要做两件核心调整：

1. 把所有WifiNetworkSpecifier相关的代码，完全包裹在API >=29的判断块内，彻底避免低版本系统加载到不存在的类。
2. 为API <29的低版本设备，保留原有的WifiConfiguration+WifiManager连接方案（虽然这个方案在API29被标记为弃用，但在低版本系统中依然完全可用）。

修改后的代码示例 #

void connect() {
    if (!wifiManager.isWifiEnabled()) {
        result.error("WIFI_TURNED_OFF", "Wifi Adapter is Offline", "Please Turn on the wifi adapter");
        return;
    }

    // 分版本处理WiFi连接逻辑
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
        // Android 10及以上，使用WifiNetworkSpecifier方案
        WifiNetworkSpecifier.Builder builder = new WifiNetworkSpecifier.Builder()
                .setSsidPattern(new PatternMatcher(ssid, PatternMatcher.PATTERN_PREFIX))
                .setWpa2Passphrase(password);
        WifiNetworkSpecifier wifiNetworkSpecifier = builder.build();

        NetworkRequest.Builder networkRequestBuilder = new NetworkRequest.Builder()
                .addTransportType(NetworkCapabilities.TRANSPORT_WIFI)
                .addCapability(NetworkCapabilities.NET_CAPABILITY_NOT_RESTRICTED)
                .addCapability(NetworkCapabilities.NET_CAPABILITY_TRUSTED);

        networkRequestBuilder.setNetworkSpecifier(wifiNetworkSpecifier);
        NetworkRequest networkRequest = networkRequestBuilder.build();

        ConnectivityManager cm = (ConnectivityManager) context.getApplicationContext().getSystemService(Context.CONNECTIVITY_SERVICE);
        if (cm != null) {
            cm.requestNetwork(networkRequest, new ConnectivityManager.NetworkCallback() {
                @Override
                public void onAvailable(@NonNull Network network) {
                    Log.e("WIFIDelegate", "available");
                    super.onAvailable(network);
                }

                @Override
                public void onUnavailable() {
                    Log.e("WIFIDelegate", "Not available");
                    super.onUnavailable();
                }
            });
        } else {
            result.error("Connectivity_Manager_Not_Available", "Connectivity Manager is not available", "Connectivity Manager is not available");
        }
    } else {
        // Android 9及以下，使用传统的WifiConfiguration方案
        WifiConfiguration wifiConfig = new WifiConfiguration();
        wifiConfig.SSID = String.format("\"%s\"", ssid);
        wifiConfig.preSharedKey = String.format("\"%s\"", password);

        // 添加配置并连接
        int netId = wifiManager.addNetwork(wifiConfig);
        boolean isConnected = wifiManager.enableNetwork(netId, true);
        if (isConnected) {
            Log.e("WIFIDelegate", "Connected via traditional method");
        } else {
            result.error("CONNECT_FAILED", "Failed to connect to WiFi", "Traditional connection method failed");
        }
    }
}

关键注意事项 #

• 权限适配：
  • API <29：需要在AndroidManifest.xml中声明ACCESS_WIFI_STATE、CHANGE_WIFI_STATE权限。
  • API >=29：除了上述权限，还需要ACCESS_FINE_LOCATION权限，并且需要用户开启位置服务（Android系统要求获取WiFi列表必须开启位置服务）。
• 类加载时机：永远不要在API版本判断之外初始化高版本系统才有的类，哪怕你觉得代码不会执行到那里——类加载是在代码执行前完成的，低版本系统会直接因为找不到类而崩溃。
• 测试覆盖：务必在目标API等级的设备上测试，避免出现版本兼容问题。

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