Enum Error 

pub enum Error {
    Http(String),
    RouteNotFound(String),
    MethodNotAllowed(String),
    DependencyInjection(String),
    ProviderNotFound(String),
    Serialization(String),
    Deserialization(String),
    Validation(String),
    Internal(String),
    Forbidden(String),
    Io(Error),
    BadRequest(String),
    Unauthorized(String),
    PaymentRequired(String),
    NotFound(String),
    NotAcceptable(String),
    ProxyAuthenticationRequired(String),
    RequestTimeout(String),
    Conflict(String),
    Gone(String),
    LengthRequired(String),
    PreconditionFailed(String),
    PayloadTooLarge(String),
    UriTooLong(String),
    UnsupportedMediaType(String),
    RangeNotSatisfiable(String),
    ExpectationFailed(String),
    ImATeapot(String),
    MisdirectedRequest(String),
    UnprocessableEntity(String),
    Locked(String),
    FailedDependency(String),
    TooEarly(String),
    UpgradeRequired(String),
    PreconditionRequired(String),
    TooManyRequests(String),
    RequestHeaderFieldsTooLarge(String),
    UnavailableForLegalReasons(String),
    NotImplemented(String),
    BadGateway(String),
    ServiceUnavailable(String),
    GatewayTimeout(String),
    HttpVersionNotSupported(String),
    VariantAlsoNegotiates(String),
    InsufficientStorage(String),
    LoopDetected(String),
    NotExtended(String),
    NetworkAuthenticationRequired(String),
}

Variants

Http(String)

RouteNotFound(String)

MethodNotAllowed(String)

DependencyInjection(String)

ProviderNotFound(String)

Serialization(String)

Deserialization(String)

Validation(String)

Internal(String)

Forbidden(String)

Io(Error)

BadRequest(String)

Unauthorized(String)

PaymentRequired(String)

NotFound(String)

NotAcceptable(String)

ProxyAuthenticationRequired(String)

RequestTimeout(String)

Conflict(String)

Gone(String)

LengthRequired(String)

PreconditionFailed(String)

PayloadTooLarge(String)

UriTooLong(String)

UnsupportedMediaType(String)

RangeNotSatisfiable(String)

ExpectationFailed(String)

ImATeapot(String)

MisdirectedRequest(String)

UnprocessableEntity(String)

Locked(String)

FailedDependency(String)

TooEarly(String)

UpgradeRequired(String)

PreconditionRequired(String)

TooManyRequests(String)

RequestHeaderFieldsTooLarge(String)

UnavailableForLegalReasons(String)

NotImplemented(String)

BadGateway(String)

ServiceUnavailable(String)

GatewayTimeout(String)

HttpVersionNotSupported(String)

VariantAlsoNegotiates(String)

InsufficientStorage(String)

LoopDetected(String)

NotExtended(String)

NetworkAuthenticationRequired(String)

Implementations

impl Error

pub fn status_code(&self) -> u16

Get the HTTP status code for this error

pub fn http_status(&self) -> HttpStatus

Get the HttpStatus enum for this error

pub fn is_client_error(&self) -> bool

Check if this is a client error (4xx)

pub fn is_server_error(&self) -> bool

Check if this is a server error (5xx)

pub fn to_client_response(&self) -> HttpResponse

Build a client-safe HTTP response for this error.

The status code comes from Error::status_code. 4xx client errors keep their descriptive message so callers can correct their request; 5xx server errors are redacted to a generic "Internal Server Error" message so internal detail (connection strings, upstream errors, stack context) never leaks to the client. The full error should be logged separately at the call site.

The JSON body is always {"error": <message>, "status": <code>}. This is the single canonical error-to-response mapping shared by every server transport (HTTP/1, HTTP/2, HTTP/3, and the micro server) so their error responses never drift apart.

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

Create a bad request error with a message.

pub fn unauthorized(msg: impl Into<String>) -> Self

Create an unauthorized error with a message.

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

Create a forbidden error with a message.

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

Create a not found error with a message.

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

Create a conflict error with a message.

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

Create an internal server error with a message.

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

Create a validation error with a message.

pub fn timeout(msg: impl Into<String>) -> Self

Create a timeout error with a message.

pub fn rate_limited(msg: impl Into<String>) -> Self

Create a rate limit error with a message.

pub fn unavailable(msg: impl Into<String>) -> Self

Create a service unavailable error with a message.

pub fn help(&self) -> Option<&'static str>

Get a help message with suggestions for resolving this error.

Trait Implementations

impl CorrelatedErrorExt for Error

fn correlate(&self, context: CorrelationContext) -> CorrelatedError

Convert to a correlated error with context.

fn correlate_with_request(&self, request: &HttpRequest) -> CorrelatedError

Convert to a correlated error from request.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

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) -> Self

Converts to this type from the input type.