Rust使用Serde序列化结构体时如何实现动态键名序列化？

这个编译错误来自SerializeStruct的trait约束：它的serialize_field方法要求字段名参数必须是&'static str。这个设计是为了适配那些需要编译期确定结构体Schema的二进制序列化格式，但对于JSON这类支持动态键的自描述序列化格式，这个限制会阻碍运行时生成字段名的需求。

方案1：用serialize_map替代serialize_struct（无额外依赖，首选） #

对JSON这类输出格式而言，Map类型的序列化结果和结构体序列化结果完全一致，都是键值对对象。而SerializeMap的serialize_entry方法允许传入任意生命周期的可序列化值作为键，完全支持运行时生成的动态字段名，不需要满足'static约束。
直接替换自定义序列化实现即可：

impl Serialize for FooBarList {
    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
    where
        S: serde::Serializer,
    {
        let field_count = 1 + 2 * self.items.len();
        // 初始化map序列化器，传入预估的键值对数量提升性能
        let mut map = serializer.serialize_map(Some(field_count))?;

        // 序列化固定字段name，放在前后都可以，JSON字段顺序不影响语义
        map.serialize_entry("name", &self.name)?;

        for (idx, item) in self.items.iter().enumerate() {
            let seq = idx + 1;
            // 动态生成的字段名直接传入即可，无生命周期限制
            map.serialize_entry(&format!("foo{}", seq), &item.foo)?;
            map.serialize_entry(&format!("bar{}", seq), &item.bar)?;
        }

        map.end()
    }
}

用serde_json测试的话，这个实现输出的结果和预期的扁平化结构完全一致，没有额外运行时开销。

方案2：保留结构体序列化语义（适配区分struct/map的序列化格式） #

如果使用的序列化格式会严格区分结构体和Map类型（比如部分二进制格式），无法直接用Map替代，可以借助serde的flatten机制实现，不需要破坏现有结构：

use serde::{Serialize, Serializer};

#[derive(Serialize)]
pub struct FooBar {
    pub foo: i32,
    pub bar: i32
}

pub struct FooBarList {
    items: Vec<FooBar>,
    name: String
}

// 辅助序列化结构，固定字段+扁平化动态字段
#[derive(Serialize)]
struct FlatSerialize<'a> {
    name: &'a str,
    #[serde(flatten)]
    dynamic_fields: DynamicItemFields<'a>,
}

// 包装items列表，负责序列化动态生成的fooN/barN字段
struct DynamicItemFields<'a>(&'a [FooBar]);

impl<'a> Serialize for DynamicItemFields<'a> {
    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
    where S: Serializer {
        let mut map = serializer.serialize_map(Some(2 * self.0.len()))?;
        for (idx, item) in self.0.iter().enumerate() {
            let seq = idx + 1;
            map.serialize_entry(&format!("foo{}", seq), &item.foo)?;
            map.serialize_entry(&format!("bar{}", seq), &item.bar)?;
        }
        map.end()
    }
}

impl Serialize for FooBarList {
    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
    where S: Serializer {
        FlatSerialize {
            name: &self.name,
            dynamic_fields: DynamicItemFields(&self.items),
        }.serialize(serializer)
    }
}

这个实现最终输出的内容和方案1完全相同，且序列化过程中会被识别为结构体类型，兼容对schema有严格要求的序列化格式。

不要为了通过编译用unsafe把动态生成的字符串强转成&'static str，这种做法会在序列化过程中触发悬垂指针，导致未定义行为，完全没有必要。如果只是输出JSON，直接用方案1即可，代码最简洁性能也最优。

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