Enum Error 

#[non_exhaustive]
pub enum Error {
    Hyper(Error),
    HttpParse(ParseError),
    HttpStatus(StatusError),
    Io(Error),
    SerdeJson(Error),
    InvalidUri(InvalidUri),
    H3Connection(ConnectionError),
    H3Stream(StreamError),
    H3SendDatagram(SendDatagramError),
    Anyhow(Error),
    Eyre(Report),
    Other(BoxedError),
}

The main error type used throughout Salvo.

This enum encompasses all error types that can occur during request processing, from low-level I/O errors to HTTP-specific errors.

Rendering

Error implements Scribe, which means it can be rendered directly to a response. Most error variants render as a 500 Internal Server Error, except for HttpStatus which uses the status code from the contained StatusError.

Error Conversion

Common error types automatically convert to Error:

use salvo_core::Error;

// I/O errors
let io_err: Error = std::io::Error::new(std::io::ErrorKind::NotFound, "file not found").into();

// JSON errors
let json_err: Error = serde_json::from_str::<()>("invalid").unwrap_err().into();

// Custom errors
let custom: Error = Error::other(MyError);

Feature-Gated Variants

Some variants are only available with specific features:

• quinn: HTTP/3 error variants
• anyhow: anyhow::Error support
• eyre: eyre::Report support

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Hyper(Error)

Error from the hyper HTTP library.

These errors typically occur during low-level HTTP processing.

HttpParse(ParseError)

HTTP parsing error.

Occurs when request data cannot be parsed correctly.

HttpStatus(StatusError)

HTTP status error with an associated status code.

Unlike other variants, this error uses its contained status code when rendering to a response.

Io(Error)

Standard I/O error.

Common for file operations and network issues.

SerdeJson(Error)

JSON serialization/deserialization error.

InvalidUri(InvalidUri)

Invalid URI error.

Occurs when a URI cannot be parsed.

H3Connection(ConnectionError)

Available on crate feature quinn only.

HTTP/3 connection error (requires quinn feature).

H3Stream(StreamError)

Available on crate feature quinn only.

HTTP/3 stream error (requires quinn feature).

H3SendDatagram(SendDatagramError)

Available on crate feature quinn only.

HTTP/3 datagram send error (requires quinn feature).

Anyhow(Error)

Available on crate feature anyhow only.

Error from the anyhow crate (requires anyhow feature).

Eyre(Report)

Available on crate feature eyre only.

Error from the eyre crate (requires eyre feature).

Other(BoxedError)

Any other error type wrapped as a boxed trait object.

Use Error::other to create this variant from any error type.

Implementations

impl Error

pub fn other(error: impl Into<BoxedError>) -> Self

Creates an Error from any error type.

This is useful for wrapping custom error types that don’t have a dedicated variant in the Error enum.

Example

use salvo_core::Error;

#[derive(Debug)]
struct MyError(String);

impl std::fmt::Display for MyError {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(f, "{}", self.0)
    }
}

impl std::error::Error for MyError {}

let error = Error::other(MyError("something went wrong".into()));

Trait Implementations

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, f: &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<Box<dyn Error + Sync + Send>> for Error

fn from(e: BoxedError) -> Self

Converts to this type from the input type.

impl From<ConnectionError> for Error

Available on crate feature quinn only.

fn from(e: ConnectionError) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(e: IoError) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

Available on crate feature anyhow only.

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<Infallible> for Error

fn from(infallible: Infallible) -> Self

Converts to this type from the input type.

impl From<InvalidUri> for Error

fn from(e: InvalidUri) -> Self

Converts to this type from the input type.

impl From<ParseError> for Error

fn from(d: ParseError) -> Self

Converts to this type from the input type.

impl From<Report> for Error

Available on crate feature eyre only.

fn from(e: Report) -> Self

Converts to this type from the input type.

impl From<SendDatagramError> for Error

Available on crate feature quinn only.

fn from(e: SendDatagramError) -> Self

Converts to this type from the input type.

impl From<StatusError> for Error

fn from(e: StatusError) -> Self

Converts to this type from the input type.

impl From<StreamError> for Error

Available on crate feature quinn only.

fn from(e: StreamError) -> Self

Converts to this type from the input type.

impl Scribe for Error

fn render(self, res: &mut Response)

Render data to Response.