Enum Error 

pub enum Error {
    Http(String),
    Status(u16, String),
    Unauthorized(String),
    Forbidden(String),
    Di(String),
    Routing(String),
    Serialization(Error),
    ResponseSerialization(Error),
    State(String),
    Internal(String),
    Message(String),
    Validation(String),
    NotFound(String),
    Conflict(String),
    PayloadTooLarge(String),
    UnsupportedMediaType(String),
    Problem(Box<ProblemDetails>),
}

Framework-wide error type.

Variants

Http(String)

Status(u16, String)

Unauthorized(String)

Forbidden(String)

Di(String)

Routing(String)

Serialization(Error)

ResponseSerialization(Error)

Serializing the response failed — a server-side defect, not a bad request.

Kept separate from Error::Serialization (which stays on the request parsing path and maps to 400) so that a DTO which cannot be serialized is reported as 500 instead of blaming the client. There is no #[from] because that conversion is already taken by Serialization; call sites convert explicitly with .map_err(Error::ResponseSerialization).

State(String)

A server-side state-machine / programming error, e.g. the response body state does not allow the requested operation. Maps to 500.

Internal(String)

Message(String)

Validation(String)

Validation error with user-readable message.

NotFound(String)

Resource not found.

Conflict(String)

Optimistic concurrency or state conflict.

PayloadTooLarge(String)

Request body (or one uploaded file) exceeded the configured limit.

UnsupportedMediaType(String)

Request content type is not supported by the target endpoint.

Problem(Box<ProblemDetails>)

A fully-formed problem response (validation, binding failure).

Carried as-is instead of being flattened into a message so the host can write the status and the extension members (errors) verbatim.

Implementations

impl Error

pub fn status_code(&self) -> u16

Map the error to an appropriate HTTP status code.

Used by the built-in exception middleware to produce well-formed HTTP error responses.

pub fn public_detail(&self) -> Option<&str>

The client-facing detail for a 4xx response.

Display is written for operators ("Unauthorized: …", "Internal error: …"), so serving it verbatim would leak variant names and internals. This returns the variant’s own message for the errors that are safe to show, and None for 5xx/internal variants — the host then serves a stable detail and logs the original text.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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<Error> for Error

fn from(source: Error) -> Error

Converts to this type from the input type.