# account\_not\_linked (/docs/reference/errors/account_not_linked)

提供商账户未与当前用户关联，且无法自动关联。



## 这是什么？ [#这是什么]

当 OAuth 流程中，提供商账户未与当前或匹配的用户关联，并且在当前配置下无法自动关联时，就会发生此错误（例如，因为提供商不受信任、未启用账户关联，或关闭了隐式关联），即使存在匹配的用户也是如此。

## 常见原因 [#常见原因]

* 用户之前使用不同的提供商或方式注册。
* 未启用或未配置账户关联。
* 提供商邮箱与任何现有用户都不匹配。
* 关联规则（例如受信任的提供商）阻止了自动关联。

## 如何解决 [#如何解决]

### 启用或配置账户关联 [#启用或配置账户关联]

* 确保在身份验证配置中已启用账户关联。
* 如有需要，将提供商添加到 `account.accountLinking.trustedProviders`。

### 验证用户身份匹配 [#验证用户身份匹配]

* 确保提供商返回了与现有用户匹配的已验证邮箱。
* 确保匹配的现有用户具有 `emailVerified: true`，尤其是在用户记录是手动插入的情况下。

### 提示用户操作 [#提示用户操作]

* 请用户使用最初关联的提供商或方式登录。

### 检查配置一致性 [#检查配置一致性]

* 确保各部署环境间的配置一致。