Firebase JS SDK中匿名用户能否关联Email Link认证账号？

Firebase匿名账号完全支持关联Email Link（邮箱链接）认证身份，出现Unknown provider（未知身份提供方）报错是调用方式错误，不是功能不支持。

触发该报错的本质是传入关联方法的身份凭证不符合邮箱链接认证的规范：

• 直接套用邮箱密码登录的凭证生成逻辑，用了密码模式的凭证生成方法，没有使用链接模式专属的凭证构造方法
• Firebase控制台未开启邮箱链接登录能力，导致SDK无法识别对应身份提供方
• 调用关联方法前匿名用户登录态已丢失，SDK上下文异常

前置准备 #

1. 先在Firebase认证控制台开启「电子邮件/密码」登录提供商，同时勾选「允许使用电子邮件链接登录」选项，保存配置。
2. 访客首次进入应用时正常调用匿名登录接口创建匿名账号，后续收集的基础信息直接写入该匿名账号对应的用户属性/用户文档即可，不需要额外做数据迁移。

步骤1：发送邮箱认证链接 #

用户提交基础信息表单后，调用邮箱链接发送接口，注意必须配置handleCodeInApp: true，同时本地暂存用户输入的邮箱，供跳转回应用时使用：

// v9 模块化版本示例
import { getAuth, sendSignInLinkToEmail } from "firebase/auth";
const auth = getAuth();
const actionCodeSettings = {
  url: "https://你的应用域名/register-complete",
  handleCodeInApp: true
};
// 暂存邮箱到本地
window.localStorage.setItem("pendingRegisterEmail", formValues.email);
sendSignInLinkToEmail(auth, formValues.email, actionCodeSettings);

步骤2：用户点击邮箱链接跳回应用时完成关联 #

注意：这一步是最容易踩坑的环节，不要直接调用signInWithEmailLink接口，该接口会直接创建新的邮箱账号，覆盖当前匿名用户登录态，导致之前收集的数据丢失
正确逻辑是先校验链接合法性，再生成邮箱链接专属凭证，最后调用当前匿名用户实例的关联方法完成绑定：

import { getAuth, isSignInWithEmailLink, EmailAuthProvider, linkWithCredential } from "firebase/auth";
const auth = getAuth();
if (isSignInWithEmailLink(auth, window.location.href)) {
  const email = window.localStorage.getItem("pendingRegisterEmail");
  if (!email) {
    // 本地无暂存邮箱，引导用户重新输入邮箱完成校验即可
    return
  }
  // 生成邮箱链接模式专属的认证凭证，注意不要用credential方法（该方法为邮箱密码模式专用）
  const linkCredential = EmailAuthProvider.credentialWithLink(email, window.location.href);
  // 用当前登录的匿名用户执行关联操作
  linkWithCredential(auth.currentUser, linkCredential)
    .then((res) => {
      // 关联成功，此时用户isAnonymous字段自动变为false，匿名账号下的所有数据全部保留
      window.localStorage.removeItem("pendingRegisterEmail");
      // 跳转到应用首页即可
    })
    .catch((err) => {
      // 常规错误处理：比如该邮箱已绑定其他账号、链接过期等场景
      console.log("关联失败", err.code, err.message);
    })
}

• 凭证生成必须调用EmailAuthProvider.credentialWithLink()，如果误用给邮箱密码登录设计的EmailAuthProvider.credential(email, password)方法，100%会触发Unknown provider报错。
• 关联操作必须保证匿名用户处于登录状态，如果用户点击邮箱链接前清空了浏览器缓存、主动登出，匿名账号登录态会丢失，无法完成关联，此时需要引导用户重新走注册流程。
• 发送链接时配置的url必须和Firebase认证控制台的授权域名完全匹配，否则会出现链接无效、提供方识别失败的问题。

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