如何序列化带可变属性的MongoDB文档？C# Driver BSON序列化方案

嘿，针对你这个MongoDB文档序列化的需求，我给你整理了一套实用的解决方案，刚好匹配你那几种可变属性的场景！

核心思路：用Dictionary处理动态键 #

你的identifications字段里的键名是可变的（a、b、c这类不固定的键），但每个键对应的结构是固定的{type, value}，这种场景用C#的Dictionary<string, T>来映射是最适合的——MongoDB C# Driver可以自动完成这种动态结构的序列化和反序列化。

步骤1：定义值结构类 #

先创建一个类来对应每个键下的type和value：

public class IdentificationEntry
{
    [BsonElement("type")]
    public string Type { get; set; }

    [BsonElement("value")]
    public string Value { get; set; }
}

步骤2：定义主文档类 #

在你的主文档类里，把identifications字段定义为Dictionary<string, IdentificationEntry>类型：

public class MyMongoDocument
{
    [BsonId]
    public ObjectId Id { get; set; }

    [BsonElement("identifications")]
    public Dictionary<string, IdentificationEntry> Identifications { get; set; }
}

步骤3：使用示例（序列化/反序列化） #

这样你就能正常用MongoDB Driver操作文档了，比如插入你给出的第一种示例：

var sampleDoc = new MyMongoDocument
{
    Identifications = new Dictionary<string, IdentificationEntry>
    {
        { "a", new IdentificationEntry { Type = "a", Value = "x1" } }
    }
};

// 获取集合并插入文档
var collection = mongoDatabase.GetCollection<MyMongoDocument>("your-collection-name");
await collection.InsertOneAsync(sampleDoc);

反序列化时，Driver会自动把MongoDB里的动态键（a、b、c等）映射到Dictionary的键，完美适配你给出的4种文档情况。

可选：封装自定义Identifications类 #

如果你想单独封装Identifications而不是直接用Dictionary，可以让它继承Dictionary<string, IdentificationEntry>，并加上Bson配置确保序列化逻辑正确：

[BsonDictionaryOptions(DictionaryRepresentation.Document)]
public class Identifications : Dictionary<string, IdentificationEntry>
{
    // 这里可以添加自定义业务方法，比如按type快速查找条目
    public IdentificationEntry FindByType(string targetType)
    {
        return Values.FirstOrDefault(entry => entry.Type == targetType);
    }
}

然后主文档类就可以替换成这个自定义类：

public class MyMongoDocument
{
    [BsonId]
    public ObjectId Id { get; set; }

    [BsonElement("identifications")]
    public Identifications Identifications { get; set; }
}

这种方式既保留了Dictionary的动态性，又能扩展自己的业务逻辑。

为什么不推荐固定属性类？ #

你一开始想写带[BsonElement]的固定属性类，但因为键名是可变的（没法提前预知所有可能的键），固定属性根本覆盖不了所有场景，而Dictionary天生就是为这种动态键值对设计的，是处理MongoDB动态结构的最佳实践。

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