Enum AuthError 

pub enum AuthError {
    BadRequest(String),
    InvalidRequest(String),
    Validation(String),
    InvalidCredentials,
    Unauthenticated,
    AuthenticationFailed(String),
    SessionNotFound,
    Forbidden(String),
    BannedUser(String),
    Unauthorized,
    UserNotFound,
    NotFound(String),
    Conflict(String),
    PayloadTooLarge(String),
    UnprocessableEntity(String),
    RateLimited,
    NotImplemented(String),
    Config(String),
    Database(DatabaseError),
    Serialization(Error),
    Plugin {
        plugin: String,
        message: String,
    },
    Internal(String),
    PasswordHash(String),
    Jwt(Error),
}

Authentication framework error types.

Each variant maps to an HTTP status code via AuthError::status_code. Use AuthError::to_auth_response to produce a standardized JSON response matching the better-auth OpenAPI spec: { "message": "..." }.

Variants

BadRequest(String)

InvalidRequest(String)

Validation(String)

InvalidCredentials

Unauthenticated

AuthenticationFailed(String)

SessionNotFound

Forbidden(String)

BannedUser(String)

Unauthorized

UserNotFound

NotFound(String)

Conflict(String)

PayloadTooLarge(String)

UnprocessableEntity(String)

RateLimited

NotImplemented(String)

Config(String)

Database(DatabaseError)

Serialization(Error)

Plugin

Fields

plugin: String

message: String

Internal(String)

PasswordHash(String)

Jwt(Error)

Implementations

impl AuthError

pub fn status_code(&self) -> u16

HTTP status code for this error.

pub fn code_from_message(message: &str) -> String

Derive the error code from the message, matching the TS better-auth behavior: message.toUpperCase().replace(/ /g, "_").replace(/[^A-Z0-9_]/g, "").

pub fn error_payload(&self) -> (u16, String, String)

Compute the HTTP status, error code, and user-facing message.

Internal errors (500) are logged and replaced with a generic message to avoid leaking details.

pub fn to_auth_response(self) -> AuthResponse

Convert this error into a standardized AuthResponse matching the better-auth spec: { "code": "...", "message": "..." }.

Named to_auth_response to avoid collision with Axum’s IntoResponse::into_response when the axum feature is enabled.

pub fn bad_request(message: impl Into<String>) -> Self

pub fn forbidden(message: impl Into<String>) -> Self

pub fn banned_user(message: impl Into<String>) -> Self

pub fn not_found(message: impl Into<String>) -> Self

pub fn conflict(message: impl Into<String>) -> Self

pub fn payload_too_large(message: impl Into<String>) -> Self

pub fn not_implemented(message: impl Into<String>) -> Self

pub fn plugin(plugin: &str, message: impl Into<String>) -> Self

pub fn config(message: impl Into<String>) -> Self

pub fn internal(message: impl Into<String>) -> Self

pub fn validation(message: impl Into<String>) -> Self

pub fn authentication_failed(message: impl Into<String>) -> Self

Trait Implementations

impl Debug for AuthError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for AuthError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for AuthError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<DatabaseError> for AuthError

fn from(source: DatabaseError) -> Self

Converts to this type from the input type.

impl From<Error> for AuthError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for AuthError

fn from(source: Error) -> Self

Converts to this type from the input type.