Rust中Serde序列化HashMap时保留字段名以兼容C#

我正在开发一个Rust项目，要求其序列化/反序列化必须与C#项目互操作。我定义了两个近似C#类的Rust结构体：

#[derive(Serialize, Deserialize, Debug)]
#[serde(rename_all = "camelCase")]
struct MyStruct<'a> {
    #[serde(flatten)]
    #[serde(borrow)]
    other_struct_map: HashMap<&'a str, MyOtherStruct<'a>>
}

#[derive(Serialize, Deserialize, Debug)]
#[serde(rename_all = "camelCase")]
struct MyOtherStruct<'a> {
    #[serde(flatten)]
    #[serde(borrow)]
    data: HashMap<&'a str, &'a str>
}

原本使用#[serde(flatten)]是因为结果接近需求（误以为HashMap未泛型实现Deserialize/Serialize），但序列化结果不符合C#预期。当前Rust序列化结果为：

{
    "key1": {
        "key2": "value2",
        "key1": "value1"
    }
}

而C#期望的格式需要保留字段名，如下：

{
    "otherStructMap": {
        "data": {
            "key1": {
                "key2": "value2",
                "key1": "value1"
            }
        }
    }
}

我尝试用serialize_with和MapSerializer实现通用的HashMap<&str, _>序列化方案，编译通过但结果和使用flatten时一致。需要一个适用于所有此类HashMap的通用解决方案，确保序列化时包裹字段名节点。

核心问题分析 #

#[serde(flatten)]的作用是将集合的键值对直接展开到父结构的JSON层级中，这与C#要求的保留字段名作为外层键的需求完全冲突。另外，HashMap本身原生支持serde序列化，之前的误解可能源于对&str引用类型生命周期处理的混淆。

通用解决方案 #

1. 直接移除flatten属性（最简方案）

去掉结构体中HashMap字段的#[serde(flatten)]，serde会自动将字段名（按camelCase转换后）作为JSON键，HashMap本身作为对应的值。修改后的结构体：

use serde::{Serialize, Deserialize};
use std::collections::HashMap;

#[derive(Serialize, Deserialize, Debug)]
#[serde(rename_all = "camelCase")]
struct MyStruct<'a> {
    #[serde(borrow)]
    other_struct_map: HashMap<&'a str, MyOtherStruct<'a>>
}

#[derive(Serialize, Deserialize, Debug)]
#[serde(rename_all = "camelCase")]
struct MyOtherStruct<'a> {
    #[serde(borrow)]
    data: HashMap<&'a str, &'a str>
}

序列化后即可得到C#期望的格式，同时#[serde(borrow)]依然有效，确保&str引用类型的生命周期正确处理。

2. 通用Map包装器（复用场景）

如果需要对多个HashMap字段做统一的生命周期和序列化处理，可以定义通用包装结构体：

use serde::{Serialize, Deserialize};
use std::collections::HashMap;

#[derive(Serialize, Deserialize, Debug)]
#[serde(transparent)]
struct MapWrapper<'a, V: Serialize + Deserialize<'a>> {
    #[serde(borrow)]
    inner: HashMap<&'a str, V>,
}

// 结构体中使用包装器
#[derive(Serialize, Deserialize, Debug)]
#[serde(rename_all = "camelCase")]
struct MyStruct<'a> {
    other_struct_map: MapWrapper<'a, MyOtherStruct<'a>>
}

#[derive(Serialize, Deserialize, Debug)]
#[serde(rename_all = "camelCase")]
struct MyOtherStruct<'a> {
    data: MapWrapper<'a, &'a str>
}

这个包装器可以在所有需要保留字段名的HashMap场景中复用，统一处理引用类型的生命周期问题。

3. 自定义序列化函数（灵活扩展）

如果需要额外的自定义逻辑，可以实现通用序列化函数，确保HashMap被正确包裹在字段名下：

use serde::{Serializer, Serialize};
use std::collections::HashMap;

fn serialize_map<K, V, S>(map: &HashMap<K, V>, serializer: S) -> Result<S::Ok, S::Error>
where
    K: Serialize,
    V: Serialize,
    S: Serializer,
{
    map.serialize(serializer)
}

// 字段上标注使用自定义函数
#[derive(Serialize, Deserialize, Debug)]
#[serde(rename_all = "camelCase")]
struct MyStruct<'a> {
    #[serde(borrow, serialize_with = "serialize_map")]
    other_struct_map: HashMap<&'a str, MyOtherStruct<'a>>
}

该方案效果与移除flatten一致，适合需要后续扩展序列化逻辑的场景。

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