# 无法关联账户 (/docs/reference/errors/unable_to_link_account)

无法关联该账户。



## 什么情况？ [#什么情况]

此错误仅在 OAuth 流程中尝试将提供商账户关联到当前已认证用户时发生。如果发生以下情况，Better Auth 会阻止该操作：

1. 创建/更新关联账户的数据库操作失败。
2. 根据您的认证配置（`account.accountLinking.trustedProviders`），该提供商不被视为可信任以进行关联。

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

* 该提供商未列入 `account.accountLinking.trustedProviders`。
* 不同环境（开发/测试/生产）配置不一致，导致某个环境中该提供商被视为不可信。
* 数据库写入失败，原因可能是唯一约束、外键冲突或事务/连接问题。
* 并发链接同一提供商时发生竞态条件，造成冲突。
* 待执行的迁移或服务间模式不匹配导致写入失败。

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

### 允许关联指定提供商 [#允许关联指定提供商]

* 将提供商 ID（例如 `github`、`google`）添加到认证配置中的 `account.accountLinking.trustedProviders`。
* 确认您使用的提供商 ID/别名是集成所期待的。

### 修复数据库可靠性和约束 [#修复数据库可靠性和约束]

* 执行待处理的迁移，确保数据库模式与当前 Better Auth 版本匹配。
* 调查数据库错误（死锁、超时、连接池限制）并在适当时重试。

### Verify environment configuration [#verify-environment-configuration]

* 确保相同的认证配置部署到所有环境，并且环境变量按预期加载。
* 确认运行时看到预期的 `trustedProviders` 列表。