如何在Axum服务器路由中调用结构体方法？

你遇到的第一个错误是因为直接尝试将结构体方法api.hello作为handler传递——Rust中方法不能直接当作独立函数使用，它需要绑定到结构体实例的引用（&self），而Axum的get函数需要的是符合特定签名的函数或闭包。

而你尝试的闭包方案出现生命周期错误，是因为Axum要求handler返回的Future必须满足'static生命周期（服务器运行期间handler可能被多次调用，不能依赖栈上的临时变量），你的闭包捕获的实例没有满足这个要求。

下面提供两种可行的解决方案：

方案一：利用Clone特性包装闭包 #

因为你的Api结构体已经实现了Clone，可以通过在闭包里克隆实例来满足生命周期要求：

use axum::{http::StatusCode, routing::get, Router, Server};

#[derive(Clone)]
struct Api {
    name: String
}

impl Api {
    async fn hello(&self) -> Result<String, StatusCode> {
        Ok(format!("Hello {}!", self.name))
    }
}

#[tokio::main]
async fn main() {
    let api = Api { name: "Alice".to_owned() };

    // 包装闭包，克隆实例后传入async块
    let hello_handler = move || {
        let api = api.clone();
        async move {
            api.hello().await.unwrap_or_else(|_| "error".to_owned())
        }
    };

    let app = Router::new()
        .route("/hello-user", get(hello_handler));

    Server::bind(&([127, 0, 0, 1], 3000).into())
        .serve(app.into_make_service())
        .await
        .unwrap();
}

这里外层闭包move捕获原始api，然后克隆一份给内部的async块，确保async块捕获的实例是'static的，符合Axum的要求。

方案二：使用Axum的State机制（推荐） #

Axum提供了State提取器，可以将结构体实例全局注入到路由中，供所有handler共享，这是更符合Axum设计模式的做法：

use axum::{extract::State, http::StatusCode, routing::get, Router, Server};

#[derive(Clone)]
struct Api {
    name: String
}

impl Api {
    async fn hello(&self) -> Result<String, StatusCode> {
        Ok(format!("Hello {}!", self.name))
    }
}

// 定义handler，通过State提取器获取Api实例
async fn hello_handler(State(api): State<Api>) -> Result<String, StatusCode> {
    api.hello().await
}

#[tokio::main]
async fn main() {
    let api = Api { name: "Alice".to_owned() };

    // 将Api实例作为State传入路由
    let app = Router::new()
        .route("/hello-user", get(hello_handler))
        .with_state(api);

    Server::bind(&([127, 0, 0, 1], 3000).into())
        .serve(app.into_make_service())
        .await
        .unwrap();
}

这种方式不需要手动处理克隆和生命周期，Axum会自动管理实例的传递，同时方便多个路由共享同一个Api实例，代码结构更清晰。

内容的提问来源于stack exchange，提问作者SomeRandomPhysicist