如何让Serde根据全局运行时条件控制是否跳过字段序列化

首先明确：skip_serializing_if的回调仅能获取当前字段的值，无法访问外部运行时上下文，确实不适合这个需求，以下是两种无需全局状态、线程安全的实现方案：

方案1：手动实现序列化（性能最优，生产环境推荐） #

通过泛型包装器携带运行时条件上下文，完全和业务数据解耦，性能和默认派生序列化的表现几乎一致：

1. 先定义条件标记类型和业务结构体：

use serde::{Serialize, Serializer, ser::SerializeStruct};

// 运行时条件：示例为客户端类型，可根据需求替换为任意条件
enum ClientType {
    Mobile,
    Desktop,
    ThirdParty,
}

// 原始业务结构体，不需要修改原有定义
#[derive(Debug, Default)]
struct UserInfo {
    uid: u64,
    name: String,
    // 需要条件控制序列化的字段
    secret_extra: Option<String>,
}

2. 定义带上下文的序列化包装器，并手动实现序列化逻辑：

#[derive(Debug)]
struct ConditionalSerialize<T> {
    data: T,
    cond: ClientType,
}

impl Serialize for ConditionalSerialize<UserInfo> {
    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
    where
        S: Serializer,
    {
        // 先根据条件计算最终序列化的字段总数
        let field_cnt = match self.cond {
            ClientType::Mobile | ClientType::Desktop => 3,
            _ => 2,
        };
        let mut struct_ser = serializer.serialize_struct("UserInfo", field_cnt)?;
        // 固定序列化的公共字段
        struct_ser.serialize_field("uid", &self.data.uid)?;
        struct_ser.serialize_field("name", &self.data.name)?;
        // 条件判断是否序列化目标字段，值为None也会生成null，符合需求
        if matches!(self.cond, ClientType::Mobile | ClientType::Desktop) {
            struct_ser.serialize_field("secret_extra", &self.data.secret_extra)?;
        }
        struct_ser.end()
    }
}

3. 使用方式：

// 运行时获取到条件后，包装数据再序列化即可
let user = UserInfo::default();
let wrapper = ConditionalSerialize { data: user, cond: ClientType::Mobile };
let json_str = serde_json::to_string(&wrapper)?;

方案2：动态修改JSON对象（代码最少，适合轻量场景） #

如果你的字段数量少、序列化频率不高，可以直接序列化后动态增删字段，不需要手动实现序列化：

use serde_json::json;

let user = UserInfo::default();
let mut json_val = json!(user);
// 运行时判断条件，动态插入目标字段
if matches!(client_type, ClientType::Mobile | ClientType::Desktop) {
    json_val.as_object_mut()
        .unwrap()
        .insert("secret_extra".to_string(), json!(user.secret_extra));
}
let json_str = json_val.to_string();

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