本文详解如何在 Android Studio 中编写代码，准确判断设备是否启用了仅移动数据（蜂窝网络）连接，避免将 Wi-Fi 误判为有效网络，从而实现更精确的网络状态提示与 API 调用控制。
本文详解如何在 android 应用中编写代码，准确判断设备是否启用了**仅移动数据（蜂窝网络）连接**，避免将 wi-fi 误判为有效网络，从而实现更精确的网络状态提示与 api 调用控制。
在 Android 开发中，ConnectivityManager.getActiveNetworkInfo() 已被标记为废弃（deprecated），但其核心逻辑仍适用于兼容旧版本（API 优先识别当前活跃网络类型，再严格限定为 TYPE_MOBILE（含 TYPE_MOBILE_MMS、TYPE_MOBILE_SUPL 等子类型），彻底排除 Wi-Fi、以太网、蓝牙等其他网络。
以下是推荐使用的兼容性方法（支持 API 16+）：
@RequiresApi(api = Build.VERSION_CODES.LOLLIPOP)
public static boolean isMobileDataActive(@NonNull Context context) {
ConnectivityManager cm = context.getSystemService(ConnectivityManager.class);
if (cm == null) return false;
Network network = cm.getActiveNetwork();
if (network == null) return false;
NetworkCapabilities caps = cm.getNetworkCapabilities(network);
return caps != null &&
caps.hasCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET) &&
caps.hasTransport(NetworkCapabilities.TRANSPORT_CELLULAR);
}
// 兼容低版本（API < 21）的备选方案（需注意已废弃）
@SuppressLint("ObsoleteSdkInt")
public static boolean isMobileDataActiveLegacy(@NonNull Context context) {
ConnectivityManager cm = (ConnectivityManager) context.getSystemService(Context.CONNECTIVITY_SERVICE);
if (cm == null) return false;
NetworkInfo activeNetwork = cm.getActiveNetworkInfo();
return activeNetwork != null &&
activeNetwork.isConnected() &&
activeNetwork.getType() == ConnectivityManager.TYPE_MOBILE;
}✅ 关键要点说明：
- getType() == ConnectivityManager.TYPE_MOBILE 是区分蜂窝网络的核心条件；Wi-Fi 对应 TYPE_WIFI，因此不会误触发；
- 使用 isConnected()（而非 isConnectedOrConnecting()）可避免在连接建立中就提前返回 true，提升可靠性；
- Android 5.0（API 21）起推荐使用 NetworkCapabilities 配合 TRANSPORT_CELLULAR，语义更清晰、行为更稳定；
- 若需支持多 SIM 卡场景，TYPE_MOBILE 自动涵盖所有蜂窝接口（无需额外处理）。
? 权限声明（必需）
请确保 AndroidManifest.xml 中已声明以下权限：
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
⚠️ 注意事项：
- 该检测不涉及移动数据开关状态（即“移动数据总开关”是否开启），仅反映当前是否有活跃的蜂窝网络连接；如需监听开关变化，需结合 ConnectivityManager.NetworkCallback（API 21+）动态注册；
- 某些定制 ROM 或 Android 9+ 设备可能对后台网络状态访问有限制，建议在主线程外调用并做好空值防护；
- 测试时请关闭 Wi-Fi 并启用蜂窝数据，同时开启飞行模式对比验证逻辑健壮性。
总结：替换原有泛化的 verifyNetWork() 方法，改用基于 TYPE_MOBILE 或 TRANSPORT_CELLULAR 的专用检测逻辑，即可实现「仅当蜂窝网络可用时才允许 API 请求」的目标，显著提升用户体验与错误提示的准确性。
