Actix Web中两个PUT路由冲突导致上传对象接口无法匹配的问题

看起来你遇到了两个PUT路由的匹配异常，上传对象的接口一直返回404，我们来一步步排查解决这个问题。

首先分析你的代码核心问题：

1. 路径参数解析错误：你的put_object函数使用了两个独立的web::Path<String>参数，这是Actix Web不支持的写法。框架要求多段路径的参数必须用元组或者自定义结构体统一包裹，否则无法正确解析路径中的多个参数，这也是导致该路由无法匹配请求、返回404的根本原因。
2. 路由注册顺序的潜在风险：虽然当前你先注册了put_object再注册create_bucket，但如果后续调整顺序，单段路径的路由会不会误匹配多段请求？其实不会——因为/{bucket_name}只能匹配单段路径（比如/sardor），而/{bucket}/{object_name}匹配两段路径（比如/sardo/5.png），两者路径段数不同，Actix Web会优先匹配段数匹配的路由。不过规范起见，还是建议把更具体的多段路由放在前面注册，避免潜在歧义。

接下来是具体修复方案：

方案一：用元组包裹路径参数 #

直接修改put_object的参数定义，用元组接收两个路径参数：

#[put("/{bucket}/{object_name}")]
pub async fn put_object(
    path: web::Path<(String, String)>, // 用元组统一包裹两个参数
    data: web::Data<crate::AppState>,
    _req: HttpRequest,
    mut payload: web::Payload,
) -> Result<HttpResponse, Error> {
    // 从元组中取出具体的bucket和object_name
    let (bucket, object_name) = path.into_inner();
    
    // 这里编写你的业务逻辑
    Ok(HttpResponse::Ok().finish())
}

方案二：用自定义结构体（更清晰，推荐） #

先定义一个用于解析路径参数的结构体（需要导入serde的Deserialize trait）：

use serde::Deserialize;

#[derive(Deserialize)]
struct ObjectRequestPath {
    bucket: String,
    object_name: String,
}

#[put("/{bucket}/{object_name}")]
pub async fn put_object(
    path: web::Path<ObjectRequestPath>, // 使用自定义结构体接收参数
    data: web::Data<crate::AppState>,
    _req: HttpRequest,
    mut payload: web::Payload,
) -> Result<HttpResponse, Error> {
    // 直接通过结构体字段访问参数
    let bucket = path.bucket.clone();
    let object_name = path.object_name.clone();
    
    // 这里编写你的业务逻辑
    Ok(HttpResponse::Ok().finish())
}

确认路由注册顺序 #

保持先注册更具体的多段路由，再注册通用单段路由的顺序，养成良好的编码习惯：

let server = HttpServer::new(move || {
    App::new()
        .wrap(middleware::Logger::default())
        .service(apis::put_object::put_object) // 先注册多段路由
        .service(apis::create_bucket::create_bucket) // 再注册单段路由
        .service(apis::list_buckets::list_buckets)
        .default_service(web::route().to(not_found))
        .app_data(web::Data::new(AppState {
            working_folder: config.working_folder.clone(),
        }))
});

完成以上修改后，两个PUT路由就能各自正确匹配对应的请求，不会再出现冲突或404的问题了。

备注：内容来源于stack exchange，提问作者user641101