Axum中共享Reqwest Client的类型校验问题求助

错误根源 #

你遇到的编译错误核心原因是：Axum的Router::with_state方法是替换路由的全局状态类型，而非追加多个状态。你连续调用两次with_state后，路由实际的状态类型会被覆盖为最后传入的Client，但处理器函数期望同时提取Config和Client两个State参数，这不符合Axum的Handler trait约束（处理器只能提取一个全局State实例）。

正确实现代码 #

use axum::{extract::State, routing::get, Router};
use reqwest::Client;
use std::sync::Arc;

// 统一封装所有需要共享的资源
#[derive(Clone)]
struct AppState {
    config: Config,
    client: Client,
}

struct Config {
    secret: String,
}

#[tokio::main]
async fn main() {
    let client = Client::new();
    let config = Config {
        secret: "your_secret_value".to_string(),
    };

    // 用Arc实现线程安全的共享，满足Axum对State的Clone要求
    let app_state = Arc::new(AppState { config, client });

    let app = Router::new()
        .route("/", get(index))
        .with_state(app_state); // 仅需一次传入全局状态

    axum::Server::bind(&"0.0.0.0:3000".parse().unwrap())
        .serve(app.into_make_service())
        .await
        .unwrap();
}

async fn index(State(state): State<Arc<AppState>>) -> String {
    state.client
        .get("https://example.com/")
        .header("Cookie", &state.config.secret)
        .send()
        .await
        .unwrap()
        .text()
        .await
        .unwrap()
}

关键说明 #

1. 统一状态结构体：将Config和reqwest::Client放到同一个AppState中，作为全局共享的单一状态实例。
2. Arc包装状态：Axum要求状态类型实现Clone，Arc是线程安全的共享指针，克隆时仅增加引用计数，完全符合需求。
3. reqwest Client特性：reqwest的Client内部已经通过Arc实现了高效共享，因此直接放入AppState即可，无需额外包装。
4. 移除不安全的Box::leak：之前用Box::leak获取静态引用的做法既不安全也没必要，Arc是规范的线程安全共享方案。

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