账号已关联到不同用户

什么情况？

在 OAuth 流程中，尝试将一个 OAuth 提供商账号链接到当前已认证用户时，会触发此错误， 但该提供商账号已经链接到您项目中的另一个用户。为了防止账号劫持，Better Auth 会阻止此链接并抛出此错误。

这种情况仅可能通过 OAuth 流程（例如 Google、GitHub 等）发生。 仅靠电子邮件/密码流程本身不会触发此错误。

如何解决

常见解决方案

• 以已关联该提供商账号的用户身份登录，取消该账号的链接，然后再将其链接到目标账号。
• 如果这两个账号属于同一人且您希望合并为一个用户，请合并账号：选择一个主账号， 将会话和关联账号从次要账号迁移到主账号，然后停用或删除次要账号。

常见原因

• 您之前曾在同一项目中使用该提供商登录或注册过另一个用户。
• 您有两个本地用户（例如，通过电子邮件/密码或 magic link 创建），并将该提供商关联到了其中一个；现在您正尝试将同一个提供商关联到另一个用户。
• 测试/预览环境共用了相同的 OAuth 提供商配置和数据库；该提供商账号已关联到另一条用户记录。
• 数据迁移或手动修改数据库后，留下了指向错误用户的过期关联。
• 您依赖电子邮件匹配来决定是否关联，但实际的账号标识键是 providerId 和 accountId。如果该身份属于另一位用户，关联将被阻止。

更安全的模式和预防措施

• 不要自动将提供商链接到当前登录用户，除非您明确通过用户确认所有权。
• 如果提供“关联账号”界面，请明确告知该链接将归属于哪个用户，以及如果提供商已在别处关联时应如何操作。
• 考虑仅对仅用于登录的提供商禁用关联功能，以避免意外的交叉关联。

本地调试

• 检查您的 account 数据库表。每一行都指向一个 userId，并以 providerId 和 accountId 为键。对于 OpenID Connect 提供商，accountId 是经过验证的 subject。
• 确定当前拥有该提供商关联的用户，并决定是取消关联、合并还是保持现状。
• 确认您的应用已连接到预期的数据库和环境（dev/staging/prod），以避免因凭据共用或环境变量配置错误而产生混淆。

提供商注意事项

• 确保您从提供商请求稳定的用户标识符，例如 OpenID Connect 的 openid 作用域，以便 accountId 在不同会话之间保持一致。
• 如果您更改了提供商项目/租户，标识符可能会有所不同；请确认您为该环境关联的是正确的提供商凭据。