Android如何获取当前网络类型及状态？

Question

在Android开发中，如何准确获取当前设备的网络类型（如Wi-Fi、4G、5G）及网络连接状态是常见的需求。然而，使用`ConnectivityManager`和`NetworkInfo`时，在API 29（Android 10）及以上版本中，部分字段已被废弃，无法直接获取详细网络类型。开发者常遇到的问题是：如何兼容新旧API，精准判断当前网络为Wi-Fi、蜂窝数据（并区分4G/5G），同时检测网络是否真正可用？此外，在未申请权限或动态权限处理不当的情况下，还可能引发安全异常或返回空值。如何设计一个稳定、兼容性强且高效的网络状态检测方案？

Answer 1

Android网络状态检测的深度解析与兼容性设计

1. 背景与挑战：从API变更看网络类型获取的演进

在Android开发中，准确获取设备当前的网络类型（如Wi-Fi、4G、5G）和连接状态是一项基础但关键的功能。早期开发者依赖ConnectivityManager结合NetworkInfo来判断网络状态。然而，自Android 10（API 29）起，Google出于隐私保护考虑，废弃了NetworkInfo.getExtraInfo()和部分网络类型字段，导致无法直接获取蜂窝网络的详细类型。

这一变更带来了以下核心问题：

• 旧版API在高版本系统中返回null或受限信息
• 无法区分4G与5G等蜂窝网络类型
• 未申请权限时抛出SecurityException
• 网络“连接”不等于“可用”，需额外验证连通性

2. 权限模型与安全异常处理

要访问网络状态，必须在AndroidManifest.xml中声明权限：

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

从Android 10开始，获取精确网络类型（如LTE vs NR）需要ACCESS_FINE_LOCATION权限，否则TelephonyManager可能返回模糊结果或抛出异常。因此，动态权限请求成为必要环节：

API等级	所需权限	说明
< 29	ACCESS_NETWORK_STATE	基本网络状态可获取
≥ 29	ACCESS_NETWORK_STATE + ACCESS_FINE_LOCATION	否则蜂窝类型受限

3. 新旧API兼容架构设计

为实现跨版本兼容，应采用分层判断策略：

1. 优先使用ConnectivityManager.getNetworkCapabilities()（API 23+）
2. 通过NetworkCapabilities.hasTransport()判断传输类型
3. 结合TelephonyManager.getDataNetworkType()（API 29+）识别蜂窝子类型
4. 降级至NetworkInfo.getType()用于低版本支持

4. 精准识别Wi-Fi、4G、5G的实现逻辑

以下是核心判断逻辑的伪代码结构：

fun getNetworkType(context: Context): NetworkType {
    val cm = context.getSystemService(Context.CONNECTIVITY_SERVICE) as ConnectivityManager
    val network = cm.activeNetwork ?: return NetworkType.NONE
    val caps = cm.getNetworkCapabilities(network) ?: return NetworkType.UNKNOWN

    return when {
        caps.hasTransport(NetworkCapabilities.TRANSPORT_WIFI) -> NetworkType.WIFI
        caps.hasTransport(NetworkCapabilities.TRANSPORT_CELLULAR) -> {
            val tm = context.getSystemService(Context.TELEPHONY_SERVICE) as TelephonyManager
            when (tm.dataNetworkType) {
                TelephonyManager.NETWORK_TYPE_LTE -> NetworkType.LTE_4G
                TelephonyManager.NETWORK_TYPE_NR -> NetworkType.NR_5G
                else -> NetworkType.CELLULAR_UNKNOWN
            }
        }
        else -> NetworkType.UNKNOWN
    }
}

5. 网络可用性检测：连接 ≠ 可用

即使设备显示已连接网络，仍可能无法访问公网（如 captive portal）。建议进行主动探测：

fun isNetworkReachable(): Boolean {
    return try {
        val sock = Socket()
        sock.connect(InetSocketAddress("8.8.8.8", 53), 1500)
        sock.close()
        true
    } catch (e: IOException) {
        false
    }
}

该方法通过尝试连接Google DNS端口53（轻量且无需HTTP协议），判断底层IP连通性。

6. 架构流程图：综合判断流程

graph TD
            A[开始] --> B{是否有网络权限?}
            B -- 否 --> C[请求动态权限]
            B -- 是 --> D[获取ActiveNetwork]
            D --> E{Network为空?}
            E -- 是 --> F[返回NONE]
            E -- 否 --> G[获取NetworkCapabilities]
            G --> H{是否为Wi-Fi?}
            H -- 是 --> I[返回WIFI]
            H -- 否 --> J{是否为蜂窝网络?}
            J -- 否 --> K[返回UNKNOWN]
            J -- 是 --> L[读取TelephonyManager.dataNetworkType]
            L --> M{是否为NR?}
            M -- 是 --> N[返回5G]
            M -- 否 --> O{是否为LTE?}
            O -- 是 --> P[返回4G]
            O -- 否 --> Q[返回CELLULAR_UNKNOWN]

7. 封装建议：构建统一的NetworkMonitor类

推荐封装一个单例类，整合权限检查、状态监听与异步探测：

• 使用registerDefaultNetworkCallback监听网络切换
• 内部维护最新网络类型缓存
• 提供isConnected()与isReachable()双层判断
• 支持LiveData或Flow暴露网络状态流

8. 实际项目中的常见坑点

开发者常忽略的问题包括：

问题	原因	解决方案
5G识别失败	缺少ACCESS_FINE_LOCATION	动态申请位置权限
模拟器返回5G	模拟器网络仿真不真实	真机测试验证
后台无法获取状态	后台限制或省电模式	使用Foreground Service
Wi-Fi但无互联网	仅连接AP未认证	增加可达性检测