MongoDB C#驱动嵌套字段映射至扁平类的实现问题

你遇到的核心问题是MongoDB驱动默认不支持通过[BsonElement("data.other_code")]这种点语法直接映射嵌套字段到扁平类属性，下面提供两种无需创建嵌套类的可行方案：

方案1：用BsonClassMap手动配置映射 #

这是最简洁的方案，直接在应用启动阶段配置类的字段映射规则，指定嵌套路径：

// 在应用初始化时执行（比如Program.cs的启动逻辑里）
BsonClassMap.RegisterClassMap<MyClass>(cm =>
{
    cm.AutoMap(); // 自动映射其他未手动配置的属性
    // 手动绑定OtherCode到MongoDB文档的data.other_code路径
    cm.MapMember(c => c.OtherCode)
        .SetElementName("data.other_code");
});

配置完成后，驱动在反序列化时会自动从data.other_code取值赋值给OtherCode，同时类型化查询的筛选器依然能正常生成data.other_code的点符号路径，完全满足你的需求。

方案2：自定义字段级序列化器 #

如果之前尝试自定义序列化器未触发，大概率是特性标记或实现细节有问题。下面是能正常工作的序列化器实现：

第一步：实现自定义序列化器 #

public class NestedPathSerializer<T> : IBsonSerializer<T>
{
    private readonly string[] _pathSegments;
    private readonly IBsonSerializer<T> _baseSerializer;

    public NestedPathSerializer(string nestedPath)
    {
        _pathSegments = nestedPath.Split('.');
        _baseSerializer = BsonSerializer.LookupSerializer<T>();
    }

    public T Deserialize(BsonDeserializationContext context, BsonDeserializationArgs args)
    {
        var reader = context.Reader;
        reader.ReadStartDocument();

        T result = default;
        // 遍历根文档找到第一层嵌套节点
        while (reader.ReadBsonType() != BsonType.EndOfDocument)
        {
            if (reader.ReadName() == _pathSegments[0])
            {
                reader.ReadStartDocument();
                // 遍历嵌套文档找到目标字段
                while (reader.ReadBsonType() != BsonType.EndOfDocument)
                {
                    if (reader.ReadName() == _pathSegments[1])
                    {
                        result = _baseSerializer.Deserialize(context, args);
                    }
                    else
                    {
                        reader.SkipValue(); // 跳过无关字段
                    }
                }
                reader.ReadEndDocument();
            }
            else
            {
                reader.SkipValue(); // 跳过无关根字段
            }
        }
        reader.ReadEndDocument();
        return result;
    }

    public void Serialize(BsonSerializationContext context, BsonSerializationArgs args, T value)
    {
        var writer = context.Writer;
        writer.WriteStartDocument();
        // 按嵌套路径写入字段
        writer.WriteStartDocument(_pathSegments[0]);
        writer.WriteName(_pathSegments[1]);
        _baseSerializer.Serialize(context, args, value);
        writer.WriteEndDocument();
        writer.WriteEndDocument();
    }

    public Type ValueType => typeof(T);
}

第二步：在属性上标记使用该序列化器 #

public class MyClass 
{
    [BsonElement("code")]
    public string Code { get; set; }
    
    // 指定序列化器并传入嵌套路径参数
    [BsonSerializer(typeof(NestedPathSerializer<string>), "data.other_code")]
    public string OtherCode { get; set; }
}

这个序列化器会精准定位到指定的嵌套路径取值，同时支持序列化时按嵌套结构写入数据，确保双向操作都正常。

排查：自定义序列化器未触发的常见原因 #

• 未在目标属性上添加[BsonSerializer]特性，或特性指定的序列化器类型/参数有误；
• 序列化器未完整实现IBsonSerializer<T>接口（缺少Serialize或Deserialize方法）；
• 全局注册的序列化器优先级低于驱动默认序列化器，导致未被调用（字段级特性的优先级更高，推荐用字段级标记）。

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