email_doesn't_match

电子邮件与账户的电子邮件不匹配。

它是什么?

此错误仅在 OAuth 账号关联过程中出现。当已登录用户尝试关联一个 OAuth 提供商账号时,如果提供商返回的电子邮件与当前认证用户的电子邮件(或您预期的该用户电子邮件)不匹配,就会发生此错误。为了防止意外的跨账号关联或账号被盗用,当电子邮件不匹配时,Better Auth 会阻止关联。

此错误不会在正常的 OAuth 登录时出现,仅限关联流程中。

常见原因

  • 用户在提供商端登录了不同的电子邮件(例如,工作邮箱与个人邮箱)。
  • 提供商返回了未验证或次级的电子邮件,且与应用账号的电子邮件不同。
  • 电子邮件标准化差异(大小写敏感性、Gmail 上的点/别名)导致不匹配。
  • 用户在应用或提供商处的电子邮件自账号创建以来发生了更改。

如何解决

让用户对齐身份信息

  • 让用户切换到使用与其应用账号相同电子邮件的正确提供商账号。
  • 或者,更新应用账号的电子邮件为预期的电子邮件(如果您的产品支持),然后重新尝试关联。

本地调试

  • 在您的应用中记录当前用户的电子邮件和提供商返回的电子邮件。
  • 检查提供商电子邮件是否已验证/是否为主邮箱,以及是否进行了任何标准化处理。
  • 确认所用的提供商凭据(开发/预发布/生产环境)以及返回的身份是否为预期的那个。