Android使用OkHttp绑定移动网络Socket出现Permission denied错误求助

• 未主动申请蜂窝网络使用权：直接从allNetworks中获取的蜂窝Network实例，系统默认未给普通应用开放socket绑定权限，WiFi网络逻辑更宽松所以可以正常运行。
• 权限缺失：Android 12（API 31）及以上版本绑定蜂窝网络socket需要定位权限，仅静态声明权限无效，必须完成动态授权。
• 厂商定制系统限制：部分国内厂商的系统网络管控会默认拦截普通应用强制指定蜂窝网络的操作。

1. 替换网络获取逻辑，主动申请蜂窝网络使用权 #

不要直接读取已存在的网络列表，通过requestNetwork向系统申请蜂窝网络的使用权限，拿到系统授权返回的Network实例后再使用：

// 构建蜂窝网络请求
val networkRequest = NetworkRequest.Builder()
    .addTransportType(NetworkCapabilities.TRANSPORT_CELLULAR)
    .addCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET)
    .build()

// 注册网络回调接收授权后的网络实例
val networkCallback = object : ConnectivityManager.NetworkCallback() {
    override fun onAvailable(network: Network) {
        super.onAvailable(network)
        // 配置OkHttp，注意同时指定对应网络的DNS解析规则
        val okHttpClient = OkHttpClient.Builder()
            .socketFactory(network.socketFactory)
            .dns { hostname -> network.getAllByName(hostname).toList() }
            .build()
        // 使用该OkHttpClient实例创建Retrofit发起请求即可
    }

    override fun onUnavailable() {
        super.onUnavailable()
        // 处理蜂窝网络不可用的异常场景
    }
}

// 发起网络申请
connectivityManager.requestNetwork(networkRequest, networkCallback)

2. 补充权限声明与动态申请 #

在AndroidManifest.xml中新增必要权限：

<!-- Android 12+ 绑定蜂窝网络必需 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<!-- targetSdk >=33 时添加，避免和WiFi权限冲突 -->
<uses-permission android:name="android.permission.NEARBY_WIFI_DEVICES" android:usesPermissionFlags="neverForLocation" />

在执行网络申请逻辑前，先向用户动态申请ACCESS_FINE_LOCATION权限，拿到授权后再执行后续操作。

3. 适配厂商系统限制 #

如果完成上述操作后仍有报错，可引导用户到应用权限设置页，开启「移动网络使用权限」「修改系统网络设置」「后台弹出界面」等相关权限，不同厂商的权限命名存在差异，可根据适配的设备做针对性引导。

• 不需要使用蜂窝网络转发时，及时调用connectivityManager.unregisterNetworkCallback(networkCallback)释放资源，避免内存泄漏。
• 在NetworkCallback的onLost回调中做降级处理，蜂窝网络断开时可切回默认网络或者提示用户网络异常。

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