iOS端Firebase电话认证时go_router出现未知路由错误

针对你遇到的iOS端Firebase电话认证后跳转到/link路由导致go_router报错的问题，本质是Firebase在iOS上会通过动态链接处理电话认证的验证回调，而你的路由配置中没有匹配该路径，以下是具体解决方法：

1. 添加专门的/link路由捕获回调 #

在go_router的路由配置中新增一个/link路由，用于处理Firebase的动态链接回调，避免路由报错：

GoRoute(
  path: '/link',
  builder: (context, state) {
    // 延迟执行，确保页面初始化完成后处理回调
    WidgetsBinding.instance.addPostFrameCallback((_) async {
      // 获取Firebase动态链接
      final dynamicLinkData = await FirebaseDynamicLinks.instance.getInitialLink();
      if (dynamicLinkData != null) {
        final authLink = dynamicLinkData.link.toString();
        // 将链接交给Firebase Auth处理验证流程
        try {
          // 电话认证的回调处理，无需传入邮箱
          await FirebaseAuth.instance.signInWithLink(
            email: '', // 电话认证可留空，或根据实际场景调整
            link: authLink,
          );
          // 验证完成后返回之前的页面
          if (context.mounted) {
            context.pop();
          }
        } catch (e) {
          // 处理认证失败情况，比如弹窗提示
          if (context.mounted) {
            ScaffoldMessenger.of(context).showSnackBar(
              SnackBar(content: Text('认证失败: ${e.toString()}')),
            );
            context.pop();
          }
        }
      } else {
        // 无有效链接时直接返回
        if (context.mounted) {
          context.pop();
        }
      }
    });
    // 显示加载状态，避免页面空白
    return const Scaffold(
      body: Center(child: CircularProgressIndicator()),
    );
  },
)

2. 确保iOS端动态链接配置正确 #

检查Info.plist文件，确认以下配置是否存在：

• 添加CFBundleURLSchemes，值为你的Firebase App ID（格式类似com.googleusercontent.apps.xxxxxx）
• 添加FirebaseDynamicLinksCustomDomains，值为你的Firebase动态链接域名（比如appid.page.link）

3. 优化认证流程的回调处理 #

在发起电话认证时，确保正确处理phoneVerificationCompleted等回调，减少对动态链接跳转的依赖：

await FirebaseAuth.instance.verifyPhoneNumber(
  phoneNumber: '+1234567890',
  verificationCompleted: (PhoneAuthCredential credential) async {
    // 自动完成认证，直接登录
    await FirebaseAuth.instance.signInWithCredential(credential);
  },
  verificationFailed: (FirebaseAuthException e) {
    // 处理验证失败逻辑
  },
  codeSent: (String verificationId, int? resendToken) {
    // 保存verificationId，用于后续手动输入验证码验证
  },
  codeAutoRetrievalTimeout: (String verificationId) {
    // 处理超时逻辑
  },
);

4. 可选：通过go_router的errorBuilder兜底处理 #

如果不想专门添加/link路由，也可以在go_router的errorBuilder中捕获该路径并处理：

GoRouter(
  errorBuilder: (context, state) {
    if (state.location.startsWith('/link')) {
      // 这里执行和上面相同的动态链接处理逻辑
      return const Scaffold(body: Center(child: CircularProgressIndicator()));
    }
    // 其他错误页面
    return Scaffold(body: Center(child: Text('页面不存在: ${state.location}')));
  },
  // 其他路由配置...
)

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