C# MongoDB驱动插入实体与BsonDocument的存储差异及动态插入问题

存储结构差异的原因 #

出现_v嵌套结构的核心原因是MongoDB .NET驱动的序列化规则与你使用的集合泛型类型不匹配：

• 插入实体类对象时，你使用的是强类型集合声明（如IMongoCollection<你的实体类类型>），驱动会加载对应实体的专属序列化器，直接将实体类的所有公共属性映射为MongoDB文档的顶层字段，不会额外生成嵌套层。
• 插入BsonDocument时出现_v包裹，几乎都是因为你声明集合时用了非BsonDocument的泛型参数（最常见的是误用IMongoCollection<object>，或者用了其他实体类泛型的集合来插入BsonDocument）：此时驱动会把BsonDocument实例当作普通的object类型值处理，默认的BsonValueSerializer会自动添加类型鉴别字段_t（标记实际类型为BsonDocument）和值字段_v（存储你实际写入的BsonDocument内容），最终就形成了你看到的嵌套结构。

动态构建文档实现同结构存储的方案 #

完全可以实现BsonDocument插入后和实体类插入的存储结构完全一致，最推荐的方案如下：
直接使用IMongoCollection<BsonDocument>类型的集合，适配你无固定实体类、动态构建文档的需求：

// 1. 声明集合时直接指定泛型参数为BsonDocument
var collection = mongoDatabase.GetCollection<BsonDocument>("你的目标集合名称");

// 2. 动态构建你需要的BsonDocument结构
var dynamicDocument = new BsonDocument
{
    {"name", "测试数据"},
    {"count", 100},
    {"extendInfo", new BsonDocument{"tag", "动态字段"}}
};

// 3. 直接插入即可，不会生成额外的_v嵌套层，存储结构与插入实体类完全一致
collection.InsertOne(dynamicDocument);

如果你因为业务限制不能修改集合的泛型声明，也可以通过给对应类型注册自定义Bson序列化器的方式，避免驱动自动生成_t、_v包装字段。

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