Firebase邮箱链接登录触发auth/argument-error错误求助排查

在Web应用中基于Firebase Authentication实现邮箱链接登录功能，按官方文档开发时，调用signInWithEmailLink(email, url)持续出现Firebase: Error (auth/argument-error)错误。已验证isSignInWithEmailLink(url)返回true，且传入的email和url格式符合要求，但问题仍未解决。

实现代码 #

loginConfirm = (url: string): Promise<any> => {
    console.log(url);
    if (this.afAuth.isSignInWithEmailLink(url)) {
      console.log("isSignInWithEmailLink worked!");
      var email: string = window.localStorage.getItem('emailForSignIn');
      if (!email) {
        email = window.prompt("Please provide your email for confirmation");
      }
      console.log(email); // verify email is correct
      console.log(url); // make sure url is the same as earlier (sanity check)
      return firebase.auth().signInWithEmailLink(email, url)
      .then((result) => {
        window.localStorage.removeItem('emailForSignIn');
        console.log("we are signed in");
        return result;
      })
      .catch((error) => {
        console.log("Error code:", error.code);
        console.log("Error message:", error.message);
        throw error;
      })
    }
    else {
      console.log("isSignInWithEmailLink did not work :/");
      return Promise.resolve();
    }
  }

完整错误栈 #

core.mjs:7739 ERROR FirebaseError: Firebase: Error (auth/argument-error).
    at we (index-e3d5d3f4.js:499:40)
    at Me (index-e3d5d3f4.js:503:15)
    at R.credentialWithLink (index-e3d5d3f4.js:3861:9)
    at index-e3d5d3f4.js:5640:42
    at Generator.next (<anonymous>)
    at e (asyncToGenerator.js:3:1)
    at P (asyncToGenerator.js:25:1)
    at asyncToGenerator.js:32:1
    at new t (zone.js:1429:21)
    at asyncToGenerator.js:21:1

• 邮箱与链接不匹配：isSignInWithEmailLink(url)仅验证链接格式合法性，不校验邮箱是否对应生成链接的账号。需确保传入的email和发送登录链接时使用的邮箱完全一致，注意Firebase邮箱区分大小写。
• URL关键参数丢失：检查url是否完整保留Firebase生成的所有参数（如oobCode、apiKey）。若前端路由对URL做过重写或参数过滤，可能导致关键参数丢失。可打印url的查询参数，确认oobCode存在且未被篡改。
• Auth实例不一致：代码同时使用了this.afAuth（AngularFireAuth实例）和firebase.auth()（原生Firebase Auth实例），若两者初始化配置不一致会触发验证失败。统一使用同一个Auth实例，比如替换为this.afAuth.signInWithEmailLink(email, url)。
• 邮箱值异常：当localStorage中无emailForSignIn时，prompt获取的邮箱可能为空或格式错误。添加邮箱格式校验逻辑，确保输入的邮箱符合规范后再传入方法。
• 链接已过期：Firebase登录链接默认有效期为1小时，过期后即使格式正确也会触发参数错误。可重新发送登录链接测试。

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