Android React Native应用连无网IoT WiFi时，无法用移动数据更新Google Map

安卓系统默认优先绑定已连接的WiFi网络，即便该WiFi无互联网连接。React Native的网络请求默认遵循系统路由策略，但iOS会自动 fallback 到移动数据，安卓无此机制，这就是导致你遇到Google Map加载失败、应用请求不走4G的原因。

1. 原生代码实现网络优先级控制（安卓） #

安卓10+支持通过ConnectivityManager指定请求需绑定具备互联网能力的网络，可通过原生模块实现：

步骤1：创建网络工具类（Kotlin） #

import android.content.Context
import android.net.ConnectivityManager
import android.net.Network
import android.net.NetworkCapabilities
import android.net.NetworkRequest
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.withContext

class NetworkUtils(private val context: Context) {
    private val connectivityManager = context.getSystemService(ConnectivityManager::class.java)

    suspend fun getValidInternetNetwork(): Network? = withContext(Dispatchers.IO) {
        val networkRequest = NetworkRequest.Builder()
            .addCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET)
            .addCapability(NetworkCapabilities.NET_CAPABILITY_VALIDATED) // 确保网络已验证可联网
            .build()

        var targetNetwork: Network? = null
        val callback = object : ConnectivityManager.NetworkCallback() {
            override fun onAvailable(network: Network) {
                targetNetwork = network
                connectivityManager.unregisterNetworkCallback(this)
            }
        }
        connectivityManager.registerNetworkCallback(networkRequest, callback)
        kotlinx.coroutines.delay(1000) // 等待回调结果
        targetNetwork
    }
}

步骤2：绑定网络到React Native请求客户端 #

在React Native的原生模块中，将获取到的有效网络绑定到OkHttp（RN默认网络客户端）：

// 示例React Native模块
class NetworkModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaModule(reactContext) {
    private val networkUtils = NetworkUtils(reactContext)

    @ReactMethod
    fun bindToInternetNetwork() {
        CoroutineScope(Dispatchers.IO).launch {
            val validNetwork = networkUtils.getValidInternetNetwork()
            validNetwork?.let { network ->
                val okHttpClient = OkHttpClient.Builder()
                    .socketFactory(network.socketFactory)
                    .build()
                // 替换RN默认的OkHttpClient
                com.facebook.react.modules.network.OkHttpClientProvider.replaceOkHttpClient(okHttpClient)
            }
        }
    }
}

在RN代码中调用该方法：

import { NativeModules } from 'react-native';
NativeModules.NetworkModule.bindToInternetNetwork();

2. 利用系统网络切换权限 #

在AndroidManifest.xml添加权限：

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

然后在原生代码中请求绑定移动数据网络：

val connectivityManager = getSystemService(ConnectivityManager::class.java)
val cellularRequest = NetworkRequest.Builder()
    .addTransportType(NetworkCapabilities.TRANSPORT_CELLULAR)
    .addCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET)
    .build()

connectivityManager.requestNetwork(cellularRequest, object : ConnectivityManager.NetworkCallback() {
    override fun onAvailable(network: Network) {
        connectivityManager.bindProcessToNetwork(network)
    }
})

此方法会将整个应用进程绑定到移动数据网络，所有请求都会走4G。

3. Google Map单独适配 #

若仅需修复Google Map，可在原生代码中为Map的网络客户端指定有效网络：

// 初始化Google Map时
val mapView = MapView(context)
val validNetwork = networkUtils.getValidInternetNetwork()
validNetwork?.let { network ->
    val mapClient = OkHttpClient.Builder()
        .socketFactory(network.socketFactory)
        .build()
    MapsInitializer.initialize(context, MapsInitializer.Renderer.LATEST) {
        val mapOptions = GoogleMapOptions()
            .mapClient(mapClient)
        mapView.getMapAsync { googleMap ->
            // 配置地图
        }
    }
}

4. 临时用户引导方案 #

部分安卓机型自带“智能网络切换”（如小米的WiFi助理、华为的智能切换），开启后系统会自动在WiFi无网时切到移动数据。可在应用内提示用户开启该功能，但此方案依赖设备系统，非应用可控。

• 使用Android Studio的Network Inspector查看请求的网络路由，确认是否走移动数据
• 检查Google Map是否正常加载瓦片图层

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