EDGE网络下Firebase Functions调用失败（INTERNAL错误）求助

我的Android应用有大量用户反馈操作未生效，经测试发现：在模拟器设置EDGE网络速度/延迟的场景下，Firebase Functions的onCall调用会失败，报错如下：

com.google.firebase.functions.FirebaseFunctionsException: INTERNAL
java.net.ConnectException: Failed to connect to us-central1-my-db-id.cloudfunctions.net/[2001:<some digits>:<some digits>:36::36]:<some digits>

相同测试环境下，其他Firebase SDK的网络请求（比如Firestore实时读写、Realtime Database操作）耗时5-6秒均能成功；正常高速网络下，Functions调用完全正常。

我使用的是官方标准代码：
Android端调用代码：

private fun readSomething(args: Map<String, Any>): Task<String> {
    return functions
        .getHttpsCallable("readSomething")
        .call(args)
        .continueWith { task ->
            // 处理结果逻辑
        }
}

云端Functions代码：

exports.readSomething = onCall((request) => {
    // 函数业务逻辑
});

我已经尝试调整不同的超时设置，但问题依旧。

1. Functions客户端默认连接配置适配不足 #

Firebase Functions的Android SDK底层HTTP客户端，默认的连接超时、重试策略和Firestore/Realtime Database的SDK不同。EDGE网络的高延迟会触发连接超时，而其他SDK的重试机制更适配慢网络。

解决方案：自定义客户端超时与重试 #

通过FirebaseFunctionsSettings配置更长的超时时间，并确保设置正确应用到Functions实例：

val settings = FirebaseFunctionsSettings.Builder()
    .setConnectTimeout(15, TimeUnit.SECONDS) // 覆盖EDGE网络下的连接耗时
    .setReadTimeout(30, TimeUnit.SECONDS) // 预留足够的响应等待时间
    .build()

functions = FirebaseFunctions.getInstance()
functions.settings = settings

2. IPv6连接兼容性问题 #

报错显示连接的是IPv6地址，部分EDGE网络环境下IPv6支持不稳定，而其他Firebase SDK可能优先使用IPv4，因此能成功连接。

解决方案：强制使用IPv4连接 #

通过自定义OkHttpClient过滤IPv4地址，让客户端优先使用IPv4：

val okHttpClient = OkHttpClient.Builder()
    .addInterceptor { chain ->
        val request = chain.request()
        val url = request.url
        val ipAddresses = InetAddress.getAllByName(url.host)
        // 筛选IPv4地址
        val ipv4Addresses = ipAddresses.filterIsInstance<Inet4Address>()
        if (ipv4Addresses.isNotEmpty()) {
            // 替换为第一个可用的IPv4地址
            val newUrl = url.newBuilder()
                .host(ipv4Addresses[0].hostAddress)
                .build()
            chain.proceed(request.newBuilder().url(newUrl).build())
        } else {
            chain.proceed(request)
        }
    }
    .build()

val settings = FirebaseFunctionsSettings.Builder()
    .setOkHttpClient(okHttpClient)
    .setConnectTimeout(15, TimeUnit.SECONDS)
    .setReadTimeout(30, TimeUnit.SECONDS)
    .build()

functions.settings = settings

3. 云端函数冷启动延迟叠加网络延迟 #

EDGE网络下，若函数长时间未被调用触发冷启动，云端启动时间+网络延迟的总和可能超过客户端超时时间，导致调用失败。

解决方案： #

• 开启Functions的预留实例：配置固定数量的预留实例，避免冷启动延迟，适合有稳定流量的场景。
• 定期预热函数：通过Cloud Scheduler定期触发函数调用，保持实例活跃。

4. 网络代理/防火墙限制 #

部分EDGE网络的代理或防火墙可能对Cloud Functions域名（us-central1-<project-id>.cloudfunctions.net）有访问限制，而Firestore/Realtime Database的域名被放行。

解决方案： #

• 确认应用已声明INTERNET权限，Android 9+设备需配置network_security_config允许访问该域名（或确保使用HTTPS）。
• 切换不同EDGE网络环境测试，排查是否为特定运营商的限制。

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