账号已关联到不同用户

什么情况？

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

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

如何解决

常见解决方案

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

常见原因

• 您之前使用同一提供商在另一个用户上登录或注册（属于同一项目）。
• 您有两个本地用户（例如通过电子邮件/密码或魔法链接创建），并将提供商链接到其中一个； 现在您尝试将同一提供商链接到另一个用户。
• 测试/预演环境共享相同的 OAuth 提供商配置和数据库；提供商账号已链接到不同的用户记录。
• 数据迁移或手动数据库编辑留下了指向错误用户的陈旧链接。
• 您依赖电子邮件匹配来决定是否关联，但实际的唯一键是提供商账号标识符 （例如 providerId + accountId）。如果该映射已存在另一个用户，链接将被阻止。

更安全的模式和预防措施

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

本地调试

• 检查您的 account 数据库表。您应该看到以 providerId（例如 'google'）和 accountId（例如 OIDC sub）为键的行，指向一个 userId。
• 确定哪个用户当前拥有该提供商链接，并决定是否取消链接、合并或保持现状。
• 验证您的应用是否连接到预期的数据库和环境（开发/预发布/生产），以避免因共享凭据或配置错误的环境变量导致混淆。

提供商注意事项

• 确保从提供商请求稳定的用户标识符（例如 OIDC openid 范围），以便 accountId 在会话间保持一致。
• 如果您更改了提供商项目/租户，标识符可能会不同；请确认您正在为当前环境关联正确的提供商凭据。