Actix Web中URL参数Vec类型反序列化失败问题求助

方案1：支持重复参数格式（&categories=1&categories=2） #

默认情况下，Actix Web依赖的serde_urlencoded库对Vec类型的解析要求参数重复传递，但如果希望单个参数值（如&categories=121）也能被解析为仅含一个元素的Vec，需要自定义反序列化逻辑：

1. 确保依赖已添加（若未添加）：

[dependencies]
actix-web = "4"
serde = { version = "1.0", features = ["derive"] }
serde_urlencoded = "0.7"

2. 编写自定义反序列化函数，同时兼容单个字符串和重复参数：

use serde::{Deserialize, Deserializer};

fn deserialize_vec_string<'de, D>(deserializer: D) -> Result<Option<Vec<String>>, D::Error>
where
    D: Deserializer<'de>,
{
    // 先尝试解析为单个字符串
    let single = Option::<String>::deserialize(deserializer);
    match single {
        Ok(Some(s)) => Ok(Some(vec![s])),
        Ok(None) => Ok(None),
        Err(_) => {
            // 解析失败则尝试按重复参数解析为Vec
            Option::<Vec<String>>::deserialize(deserializer)
        }
    }
}

3. 在结构体中应用该反序列化函数：

use actix_web::{get, web, HttpResponse};
use serde::Deserialize;

#[derive(Debug, Deserialize)]
struct ApiParams {
    name: String,
    fname: String,
    #[serde(deserialize_with = "deserialize_vec_string")]
    categories: Option<Vec<String>>,
}

#[get("/api/v1/")]
async fn get_api(params: web::Query<ApiParams>) -> HttpResponse {
    println!("{:?}", params);
    HttpResponse::Ok().json(params.into_inner())
}

此时无论是传递&categories=121还是&categories=1&categories=2，都能正确解析为Vec<String>。

方案2：支持逗号分隔格式（&categories=1,2） #

如果需要支持逗号分隔的参数值，编写专门的拆分逻辑即可：

1. 定义逗号分隔的反序列化函数：

use serde::{Deserialize, Deserializer};

fn deserialize_comma_separated_vec<'de, D>(deserializer: D) -> Result<Option<Vec<String>>, D::Error>
where
    D: Deserializer<'de>,
{
    let s = Option::<String>::deserialize(deserializer)?;
    match s {
        Some(s) => {
            let items = s.split(',')
                .map(|s| s.trim().to_string())
                .filter(|s| !s.is_empty())
                .collect();
            Ok(Some(items))
        }
        None => Ok(None),
    }
}

2. 修改结构体字段的反序列化属性：

#[derive(Debug, Deserialize)]
struct ApiParams {
    name: String,
    fname: String,
    #[serde(deserialize_with = "deserialize_comma_separated_vec")]
    categories: Option<Vec<String>>,
}

此时传递&categories=1,2,3会被解析为包含["1","2","3"]的Vec，同时兼容不传该参数的场景。

同时支持两种格式 #

如果需要同时兼容重复参数和逗号分隔格式，合并两种逻辑即可：

fn deserialize_flexible_vec<'de, D>(deserializer: D) -> Result<Option<Vec<String>>, D::Error>
where
    D: Deserializer<'de>,
{
    // 先尝试按重复参数解析为Vec
    let vec = Option::<Vec<String>>::deserialize(deserializer);
    match vec {
        Ok(Some(v)) => Ok(Some(v)),
        Ok(None) => Ok(None),
        Err(_) => {
            // 失败则尝试按逗号分隔解析
            let s = Option::<String>::deserialize(deserializer)?;
            match s {
                Some(s) => {
                    let items = s.split(',')
                        .map(|s| s.trim().to_string())
                        .filter(|s| !s.is_empty())
                        .collect();
                    Ok(Some(items))
                }
                None => Ok(None),
            }
        }
    }
}

将结构体字段的deserialize_with指向这个函数即可实现两种格式的兼容。

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