Android下忽略Captive Portal并利用WiFi连接的技术问询

我之前做WiFi自动登录应用的时候完全碰到过一模一样的坑！Android在检测到WiFi处于"需要登录"状态时，会自动把默认路由切到蜂窝网络，但其实WiFi物理连接是正常的——只是系统把普通应用的网络请求给拦截转走了。要绕开这个限制，核心思路就是强制让你的请求绑定到当前连接的WiFi网络上，下面是具体的实现步骤：

1. 获取当前已连接的WiFi Network对象 #

首先你需要拿到当前连接的WiFi对应的Network实例，这是后续绑定请求的关键：

• 用ConnectivityManager获取所有可用网络，过滤出类型为WiFi且处于已连接状态的网络：

ConnectivityManager connManager = (ConnectivityManager) getSystemService(Context.CONNECTIVITY_SERVICE);
Network targetNetwork = null;

for (Network network : connManager.getAllNetworks()) {
    NetworkInfo networkInfo = connManager.getNetworkInfo(network);
    if (networkInfo != null && networkInfo.getType() == ConnectivityManager.TYPE_WIFI && networkInfo.isConnected()) {
        targetNetwork = network;
        break;
    }
}

• 如果你需要实时监听WiFi连接状态，也可以注册NetworkCallback来获取Network对象，这样更可靠。

2. 绑定Network到你的网络请求 #

拿到targetNetwork后，就可以强制让请求通过这个WiFi网络发送了，分两种常用的网络库来说：

对于HttpURLConnection #

直接用Network的openConnection()方法代替默认的URL.openConnection()：

if (targetNetwork != null) {
    URL url = new URL("你的服务器地址");
    HttpURLConnection connection = (HttpURLConnection) targetNetwork.openConnection(url);
    // 后续正常设置请求参数、发送请求即可
    connection.setRequestMethod("GET");
    // ... 处理响应
}

对于OkHttp #

需要给OkHttpClient设置绑定到指定Network的SocketFactory：

if (targetNetwork != null) {
    OkHttpClient client = new OkHttpClient.Builder()
        .socketFactory(targetNetwork.getSocketFactory())
        .build();

    Request request = new Request.Builder()
        .url("你的服务器地址")
        .build();

    Response response = client.newCall(request).execute();
    // ... 处理响应
}

3. 必要的权限配置 #

别忘了在AndroidManifest.xml中添加这些权限：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />

如果是Android 12及以上，还需要添加NEARBY_WIFI_DEVICES权限（用于获取WiFi连接信息）：

<uses-permission android:name="android.permission.NEARBY_WIFI_DEVICES" android:usesPermissionFlags="neverForLocation" />

额外注意事项 #

• 绑定网络后，所有通过这个客户端/连接发送的请求都会走WiFi，即使系统默认网络是蜂窝也不受影响；
• 如果WiFi连接断开，绑定的请求会抛出异常，记得做好错误处理；
• 有些设备的系统可能会有更严格的网络拦截，这时候可能需要先发送一个请求到系统的Captive Portal检测地址（比如http://connectivitycheck.gstatic.com/generate_204），返回200状态码让系统认为WiFi已经登录成功，之后再发送你的业务请求——不过这一步不是必须的，取决于你的需求。

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