• 繁體中文

      • 捕捉請求中的 Panic

      Catch Panic 用於捕捉程式在處理請求時發生的崩潰。詳細 API 請參閱文件。

      注意: 使用 CatchPanic 需要在 Cargo.toml 中啟用 catch-panic 功能：

      salvo= { version = "xxx", features = ["catch-panic"] }

      中介軟體介紹

      CatchPanic 是一個用於捕捉處理程序中 panic 的中介軟體。當處理請求的過程中發生 panic 時，它會捕捉這些 panic 並將 500 Internal Server Error 寫入回應，而不是讓整個伺服器崩潰。

      重要提示: 此中介軟體應作為第一個中介軟體使用，以確保能捕捉到其他中介軟體或處理程序中的 panic。

      基本用法

      use salvo_core::prelude::*;
use salvo_extra::catch_panic::CatchPanic;

#[handler]
async fn hello() {
    panic!("panic error!");
}

#[tokio::main]
async fn main() {
    let router = Router::new().hoop(CatchPanic::new()).get(hello);
    let acceptor = TcpListener::new("0.0.0.0:8698").bind().await;
    Server::new(acceptor).serve(router).await;
}

      與其他框架的對比 快速理解概念

      Axum

      類似 Axum 中 Tower 的 catch_panic 中介軟體：

      use axum::{
    Router,
    routing::get,
    http::StatusCode,
};
use tower::ServiceBuilder;
use tower_http::catch_panic::CatchPanicLayer;

async fn panic_handler() -> &'static str {
    panic!("panic error!");
}

#[tokio::main]
async fn main() {
    let app = Router::new()
        .route("/", get(panic_handler))
        .layer(
            ServiceBuilder::new()
                .layer(CatchPanicLayer::new())
        );
    
    axum::Server::bind(&"0.0.0.0:3000".parse().unwrap())
        .serve(app.into_make_service())
        .await
        .unwrap();
}

      Gin (Go)

      在 Go 語言的 Gin 框架中，類似於 Recovery 中介軟體：

      package main

import (
    "github.com/gin-gonic/gin"
)

func main() {
    r := gin.Default() // 預設已包含 Recovery 中介軟體
    
    r.GET("/", func(c *gin.Context) {
        panic("panic error!")
    })
    
    r.Run(":8080")
}

      範例程式碼

      main.rs
      Cargo.toml
      use salvo::prelude::*;

// Handler that deliberately panics to demonstrate panic catching
#[handler]
async fn hello() {
    panic!("panic error!");
}

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

    // Set up router with CatchPanic middleware to handle panics gracefully
    // This prevents the server from crashing when a panic occurs in a handler
    let router = Router::new().hoop(CatchPanic::new()).get(hello);

    // Bind server to port 8698 and start serving
    let acceptor = TcpListener::new("0.0.0.0:8698").bind().await;
    Server::new(acceptor).serve(router).await;
}