Rust结构体JSON反序列化：可选字符串与null值处理方案咨询

你当前使用的#[serde(default)]仅能处理字段缺失的场景，无法应对API返回null的情况——serde默认会在将null反序列化为String时抛出错误。以下是几种实用的优化方案：

方案1：用Option<String>明确表示可选值 #

这是最符合Rust设计风格的方案，serde原生支持将JSON的null或缺失字段反序列化为None，有有效值时则为Some(String)，能清晰区分「字段未返回」「字段返回null」「字段有有效字符串」三种状态。

use serde::{Deserialize, Serialize};

#[derive(Debug, Deserialize, Serialize)]
struct Info {
    description: Option<String>,
}

• 优势：语义清晰，无需额外属性或自定义逻辑，serde原生支持。
• 适用场景：需要精准区分三种字段状态时优先使用。

方案2：将null转换为默认值（如空字符串） #

若不需要区分null和缺失字段，只想统一转为默认值（比如空字符串），仅靠#[serde(default)]不够，需结合自定义反序列化逻辑或serde辅助属性。

子方案2.1：自定义反序列化函数 #

自己实现逻辑，将Option<String>（对应JSON的null或缺失）转为指定默认值：

use serde::{Deserialize, Deserializer};

// 将null/缺失字段转为空字符串，可按需修改默认值
fn null_or_missing_to_empty<'de, D>(deserializer: D) -> Result<String, D::Error>
where
    D: Deserializer<'de>,
{
    let opt = Option::deserialize(deserializer)?;
    Ok(opt.unwrap_or_default())
}

#[derive(Debug, Deserialize, Serialize)]
struct Info {
    #[serde(deserialize_with = "null_or_missing_to_empty")]
    description: String,
}

• 优势：完全自定义逻辑，可将默认值改为任意字符串（比如"无描述"）。
• 劣势：需要额外编写函数，略显繁琐。

子方案2.2：兼顾序列化的简洁写法 #

如果同时需要在序列化时自动跳过未设置的字段，可在Option<String>上组合两个属性：

use serde::{Deserialize, Serialize};

#[derive(Debug, Deserialize, Serialize)]
struct Info {
    // 反序列化处理null/缺失，序列化时跳过None
    #[serde(default, skip_serializing_if = "Option::is_none")]
    description: Option<String>,
}

• 优势：同时满足反序列化处理null和序列化的简洁性需求。
• 适用场景：需要序列化结构体时不输出未设置字段的场景。

方案3：用serde_json::Value灵活处理（仅特殊场景使用） #

如果字段类型复杂或需要动态兼容非预期JSON类型，可先将字段反序列化为serde_json::Value，再手动转换为业务结构体：

use serde::{Deserialize, Serialize};
use serde_json::Value;

#[derive(Debug, Deserialize, Serialize)]
struct InfoRaw {
    description: Value,
}

// 手动转换为业务结构体
impl From<InfoRaw> for Info {
    fn from(raw: InfoRaw) -> Self {
        let description = match raw.description {
            Value::String(s) => s,
            Value::Null => String::new(),
            _ => String::new(), // 处理非预期的JSON类型
        };
        Info { description }
    }
}

#[derive(Debug, Serialize)]
struct Info {
    description: String,
}

• 优势：极端灵活，能处理任何JSON类型。
• 劣势：代码冗余，失去serde的类型安全检查，仅适合特殊兼容场景。

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