錯誤捕獲器

當 Response 的狀態碼顯示錯誤，且頁面中的 Body 為空時，salvo 會嘗試使用 Catcher 來捕捉此錯誤，並顯示一個友善的錯誤頁面。

您可以透過 Catcher::default() 返回一個系統預設的 Catcher，然後將其添加到 Service 上。

use salvo::catcher::Catcher;

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

預設的 Catcher 支援以 XML、JSON、HTML、Text 等格式發送錯誤頁面。

您可以透過為這個預設的 Catcher 添加 hoop 的方式，將自訂的錯誤捕捉程序附加到 Catcher 上。這些錯誤捕捉程序仍然是 Handler 類型。

您可以透過 hoop 為 Catcher 添加多個自訂的錯誤捕捉程序。自訂的錯誤處理程序在處理完錯誤後，可以呼叫 FlowCtrl::skip_next 方法跳過後續的錯誤程序，提前返回。

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();
    }
}

#錯誤捕獲器

錯誤捕獲器