Flutter中Firebase动态链接无效，无法完成邮箱链接登录

问题根源 #

你遇到的核心问题是Firebase生成的登录链接在通过动态链接跳转后，丢失了oobcode、mode等关键认证参数，导致isSignInWithEmailLink校验失败。主要原因集中在三个方面：

• 动态链接控制台未配置参数传递规则，导致认证参数被丢弃
• 客户端处理动态链接时错误提取了深层链接，而非包含完整参数的原始登录链接
• sendSignInLinkToEmail方法的actionCodeSettings配置错误，未关联正确的动态链接域名

可尝试的解决办法 #

1. 修复动态链接控制台参数传递配置 #

• 进入Firebase控制台 → 动态链接 → 选中你的动态链接模板 → 编辑设置
• 找到「高级选项」里的「参数传递」，开启「将所有参数从短链接传递到深层链接」
• 如果是自定义模板，手动添加规则确保oobcode、mode、apiKey这些参数被保留

2. 修正客户端动态链接处理逻辑 #

• 避免直接提取dynamicLink.link（这只会返回你配置的深层链接），要确保传入isSignInWithEmailLink的是包含完整认证参数的原始链接
• 正确的代码示例：

  final PendingDynamicLinkData? linkData = await FirebaseDynamicLinks.instance.getInitialLink();
  final Uri? fullLink = linkData?.link;
  if (fullLink != null) {
    // 直接用fullLink.toString()做校验，不要手动截取
    bool isValidLink = await FirebaseAuth.instance.isSignInWithEmailLink(fullLink.toString());
    if (isValidLink) {
      // 执行登录逻辑
    }
  }
  

• 检查代码中是否有手动截取链接、过滤参数的逻辑，这类操作会导致认证参数丢失

3. 重新配置actionCodeSettings #

• 调用sendSignInLinkToEmail时，actionCodeSettings的url必须填写你的Firebase动态链接域名（比如https://your-app.page.link），不能直接填深层链接，同时确保handleCodeInApp设为true：

  final actionCodeSettings = ActionCodeSettings(
    url: 'https://your-app.page.link', // 动态链接域名，不是深层链接
    handleCodeInApp: true,
    iOSBundleId: 'com.your.ios.bundle',
    androidPackageName: 'com.your.android.package',
    androidInstallApp: true,
  );
  
  await FirebaseAuth.instance.sendSignInLinkToEmail(
    email: userEmail,
    actionCodeSettings: actionCodeSettings,
  );
  

4. 跳过动态链接做测试 #

• 临时修改actionCodeSettings的url为你的App通用链接（比如https://yourapp.com/login），不使用动态链接，直接发送原始认证链接
• 点击链接后检查是否包含oobcode等参数，若此时isSignInWithEmailLink校验通过，说明问题完全出在动态链接的配置上

控制台额外配置检查 #

• 确认深层链接域名已添加到认证授权域名：Firebase控制台 → 认证 → 登录方法 → 邮箱/密码 → 授权域名，添加你的深层链接域名
• 检查动态链接的「链接行为」：确保App已安装时，直接打开App并传递完整链接参数，而非仅打开深层链接页面
• Android端：确认AndroidManifest.xml中正确配置了动态链接的intent-filter，能接收完整链接参数
• iOS端：确认Info.plist中配置了关联域名（associated domains），包含applinks:your-dynamic-link-domain.page.link

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