Catcher

Si el código de estado de Response es un error y el Body de la página está vacío, Salvo intentará capturar este error usando Catcher para mostrar una página de error amigable.

Puedes usar Catcher::default() para obtener un Catcher predeterminado del sistema y luego agregarlo al Service.

use salvo::catcher::Catcher;

Service::new(router).catcher(Catcher::default());

El Catcher predeterminado admite el envío de páginas de error en formatos XML, JSON, HTML y Text.

Puedes agregar manejadores de errores personalizados al Catcher añadiéndolos mediante hoop. Estos manejadores siguen siendo Handler.

Puedes agregar múltiples manejadores de errores personalizados al Catcher usando hoop. Los manejadores personalizados pueden llamar al método FlowCtrl::skip_next después de procesar el error para omitir los siguientes manejadores y retornar anticipadamente.

main.rs

Cargo.toml

custom-error-page/src/main.rs

use salvo::catcher::Catcher;
use salvo::prelude::*;

// Handler that returns a simple "Hello World" response
#[handler]
async fn hello() -> &'static str {
    "Hello World"
}

// Handler that deliberately returns a 500 Internal Server Error
#[handler]
async fn error500(res: &mut Response) {
    res.status_code(StatusCode::INTERNAL_SERVER_ERROR);
}

#[tokio::main]
async fn main() {
    // Initialize logging system
    tracing_subscriber::fmt().init();

    // Create and start server with custom error handling
    let acceptor = TcpListener::new("0.0.0.0:5800").bind().await;
    Server::new(acceptor).serve(create_service()).await;
}

// Create service with custom error handling
fn create_service() -> Service {
    // Set up router with two endpoints:
    // - / : Returns "Hello World"
    // - /500 : Triggers a 500 error
    let router = Router::new()
        .get(hello)
        .push(Router::with_path("500").get(error500));

    // Add custom error catcher for 404 Not Found errors
    Service::new(router).catcher(Catcher::default().hoop(handle404))
}

// Custom handler for 404 Not Found errors
#[handler]
async fn handle404(&self, _req: &Request, _depot: &Depot, res: &mut Response, ctrl: &mut FlowCtrl) {
    // Check if the error is a 404 Not Found
    if StatusCode::NOT_FOUND == res.status_code.unwrap_or(StatusCode::NOT_FOUND) {
        // Return custom error page
        res.render("Custom 404 Error Page");
        // Skip remaining error handlers
        ctrl.skip_rest();
    }
}

#Catcher

Catcher