如何在Axum中从URL查询参数反序列化枚举关联值

问题根源 #

serde的urlencoded格式反序列化默认仅支持无关联值的枚举变体（直接匹配变体名称），对于带关联值的变体（如Banana(u8)），无法自动解析banana(100)或JSON格式的字符串——这些格式不符合application/x-www-form-urlencoded的键值对规范，会被当作完整的变体名称字符串，因此触发"未知变体"错误。

另外你提供的代码中Fruit枚举未派生Deserialize trait，这是反序列化的必要前提，必须先补充。

解决方案：自定义反序列化逻辑 #

通过自定义反序列化函数，让枚举支持解析variant:value格式的参数值，具体步骤如下：

1. 修正枚举定义，派生必要trait

use serde::Deserialize;

#[derive(Deserialize)]
#[serde(deserialize_with = "deserialize_fruit")]
enum Fruit {
    Banana(u8),
    Apple,
}

#[derive(Deserialize)]
struct QueryParams {
    example: Fruit,
    color: String,
}

2. 编写自定义反序列化函数
   这个函数会拆分banana:100格式的参数值，分别处理变体名和关联值：

use serde::de::{self, Deserializer};
use std::str::FromStr;

fn deserialize_fruit<'de, D>(deserializer: D) -> Result<Fruit, D::Error>
where
    D: Deserializer<'de>,
{
    let param_value = String::deserialize(deserializer)?;

    // 匹配无关联值的Apple变体
    if param_value == "apple" {
        return Ok(Fruit::Apple);
    }

    // 拆分变体名和关联值
    if let Some((variant, value_str)) = param_value.split_once(':') {
        match variant {
            "banana" => {
                let num = u8::from_str(value_str)
                    .map_err(|e| de::Error::custom(format!("无效的数值: {}", e)))?;
                Ok(Fruit::Banana(num))
            }
            _ => Err(de::Error::unknown_variant(&param_value, &["banana:u8", "apple"])),
        }
    } else {
        Err(de::Error::unknown_variant(&param_value, &["banana:u8", "apple"]))
    }
}

3. 使用正确的请求参数格式
   现在可以用如下格式构造请求参数：

...?example=banana:100&color=yellow

其他可选思路 #

• 如果允许拆分参数，可以将带值的变体拆分为两个参数，比如example=banana&banana_value=100，然后在结构体中添加对应字段，再手动转换为枚举。但这种方式不如自定义反序列化直观。
• 使用serde_with crate提供的辅助工具，简化自定义反序列化的编写。

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