Android编程连接隐藏WPA2-PSK本地WiFi（ESP8266）问题

阿华AIGC实验室

2026-5-26

如何在Android中编程连接隐藏SSID的WPA2-PSK Wi-Fi网络

我来帮你解决这个问题——你遇到的核心问题是隐藏SSID的WPA2-PSK网络需要额外配置hiddenSSID = true，而且你的现有代码大概率没处理这个关键项，同时加密参数和权限配置也可能存在疏漏。下面是完整的解决方案，针对你提到的ESP8266 NodeMCU搭建的无互联网隐藏网络：

步骤1：添加必要权限

首先在AndroidManifest.xml中声明Wi-Fi和位置权限（Android 6.0+连接隐藏网络必须要位置权限）：

<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

注意：Android 6.0及以上版本，你需要在代码中动态申请ACCESS_FINE_LOCATION权限，并且确保用户开启了设备的位置服务，否则系统无法扫描到隐藏网络。

步骤2：正确配置WifiConfiguration并连接

下面是修正后的完整代码，重点处理了隐藏网络的标记、加密参数配置，以及完整的连接流程：

import android.content.Context;
import android.net.wifi.WifiConfiguration;
import android.net.wifi.WifiManager;
import android.util.Log;

import java.util.List;

public class ConnWifi {
    private static final String TAG = "WifiConnector";

    public void connectToHiddenWifi(Context context, String ssid, String password) {
        WifiManager wifiManager = (WifiManager) context.getSystemService(Context.WIFI_SERVICE);
        if (wifiManager == null) {
            Log.e(TAG, "设备不支持Wi-Fi功能");
            return;
        }

        // 先检查是否已经配置过该网络，避免重复添加
        List<WifiConfiguration> configuredNetworks = wifiManager.getConfiguredNetworks();
        if (configuredNetworks != null) {
            for (WifiConfiguration config : configuredNetworks) {
                // 去掉SSID的双引号后对比
                if (ssid.equals(config.SSID.replace("\"", ""))) {
                    // 已配置，直接尝试连接
                    wifiManager.disconnect();
                    boolean isConnected = wifiManager.enableNetwork(config.networkId, true);
                    wifiManager.reconnect();
                    Log.d(TAG, "已存在配置，连接结果：" + isConnected);
                    return;
                }
            }
        }

        // 未配置，创建新的WifiConfiguration
        WifiConfiguration config = new WifiConfiguration();
        // SSID必须用双引号包裹
        config.SSID = "\"" + ssid + "\"";
        // 关键：标记为隐藏网络
        config.hiddenSSID = true;

        // 配置WPA2-PSK加密参数
        config.preSharedKey = "\"" + password + "\""; // 密码同样需要双引号
        config.allowedAuthAlgorithms.set(WifiConfiguration.AuthAlgorithm.OPEN);
        config.allowedProtocols.set(WifiConfiguration.Protocol.RSN);
        config.allowedProtocols.set(WifiConfiguration.Protocol.WPA);
        config.allowedKeyManagement.set(WifiConfiguration.KeyMgmt.WPA_PSK);
        config.allowedPairwiseCiphers.set(WifiConfiguration.PairwiseCipher.CCMP);
        config.allowedPairwiseCiphers.set(WifiConfiguration.PairwiseCipher.TKIP);
        config.allowedGroupCiphers.set(WifiConfiguration.GroupCipher.CCMP);
        config.allowedGroupCiphers.set(WifiConfiguration.GroupCipher.TKIP);

        // 将配置添加到系统
        int networkId = wifiManager.addNetwork(config);
        if (networkId != -1) {
            // 保存配置并执行连接
            wifiManager.saveConfiguration();
            wifiManager.disconnect();
            boolean isConnected = wifiManager.enableNetwork(networkId, true);
            wifiManager.reconnect();
            Log.d(TAG, "新配置网络添加成功，连接结果：" + isConnected);
        } else {
            Log.e(TAG, "添加网络配置失败，请检查SSID和密码是否正确");
        }
    }

    // 调用示例：传入你的ESP8266的SSID和密码
    public void connectToEsp8266(Context context) {
        connectToHiddenWifi(context, "reyhan112233", "你的ESP8266Wi-Fi密码");
    }
}