Flutter使用Firebase Auth登录时报firebase_auth/unknown未知错误怎么解决？

• IPv6连通性故障：报错日志明确显示连接www.googleapis.com的IPv6地址失败，目前大量国内WiFi运营商的IPv6线路对谷歌服务的路由不通，或是本地DNS为谷歌域名返回了不可达的IPv6地址；而移动网络大多默认优先使用IPv4，对应出口路由可以正常访问谷歌服务，因此切换移动网络后登录正常。
• WiFi网络出口限制：部分企业、校园网或区域运营商会对谷歌服务IP段做访问拦截，而移动数据出口没有这类限制，也会导致WiFi下无法登录。
• 代码异常捕获不全：当前登录代码仅捕获了FirebaseAuthException类型的异常，网络连接类异常不属于该类型，因此会抛出未处理的未知报错，没有触发友好的错误提示。

网络适配处理 #

• 强制Firebase SDK优先使用IPv4：安卓端可在AndroidManifest.xml中配置网络规则禁用IPv6解析，也可自定义Firebase底层请求的DNS规则，优先返回IPv4地址；iOS端可修改NSURLSession配置，强制优先使用IPv4连接。
• 引导用户修改WiFi DNS：出现报错时可引导用户将WiFi的DNS修改为公共DNS（如8.8.8.8、114.114.114.114），避免本地DNS返回无效的谷歌服务IPv6地址。

代码逻辑修复 #

补充通用异常捕获逻辑，针对网络类错误返回友好提示，参考修改后的代码：

Future<void> signIn(
      {LocalUser user, Function onFail, Function onSucess}) async {
    loading = true;
    try {
      final UserCredential authResult = await auth.signInWithEmailAndPassword(
          email: user.email, password: user.password);

     [...原有业务代码]
  
    } on FirebaseAuthException catch (e) {
      loading = false;
      onFail(getErrorString(e));
      notifyListeners();
    } catch (e) {
      // 捕获网络异常等非认证类错误
      loading = false;
      if(e.toString().contains("Failed to connect to www.googleapis.com")){
        onFail("当前网络无法访问登录服务，请切换移动网络尝试或检查WiFi设置");
      }else{
        onFail("登录失败，请稍后重试");
      }
      notifyListeners();
    }
  }

长期适配方案 #

如果应用主要面向国内用户，建议替换Firebase Auth为国内可用的身份验证服务，从根源上避免谷歌服务连通性问题。

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