# unable\_to\_create\_user (/docs/reference/errors/unable_to_create_user)

身份验证期间无法创建用户。



## 它是什么？ [#它是什么]

当 Better Auth 在身份验证过程中无法创建新用户时，会发生此错误。通常发生在基于 OAuth 或 SSO 的注册流程中，预期会创建新的用户记录，但操作失败。

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

* 由于连接问题、超时或事务错误导致数据库写入失败。
* 用户模式中缺少必填字段或字段无效。
* 唯一约束违规（例如，电子邮件已存在）。
* 数据库模式与预期的 Better Auth 模式不匹配。
* 自定义数据库钩子（例如 `user.create`）内部抛出错误。
* 适配器或数据库客户端配置错误。

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

### 验证数据库连接 [#验证数据库连接]

* 确保你的数据库可访问且配置正确。
* 检查连接池问题、超时或查询失败。

### 验证模式和约束 [#验证模式和约束]

* 确保所有必需的用户字段都存在且类型正确。
* 检查唯一约束（例如电子邮件冲突）。

### 运行迁移 [#运行迁移]

* 确保你的数据库模式已更新到当前 Better Auth 版本。

### 检查自定义钩子 [#检查自定义钩子]

* 如果你正在使用 `databaseHooks.user.create`，请确保它不会抛出错误或返回无效数据。

### 检查日志 [#检查日志]

* 检查服务器日志以获取用户创建期间的详细错误消息。