unable\_to\_create\_user

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

它是什么?

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

常见原因

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

如何解决

验证数据库连接

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

验证模式和约束

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

运行迁移

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

检查自定义钩子

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

检查日志

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