MongoDB C#无ObjectId字段实体类查询异常如何解决？

问题原因 #

• 插入数据时，MongoDB服务端会自动为每条没有_id字段的文档生成ObjectId类型的_id存储，C#驱动不会对实体类做额外校验，所以插入可以正常执行
• 查询时，驱动默认需要将MongoDB返回的完整文档反序列化为你的实体类，默认配置下要求文档中所有字段都能和实体类字段匹配映射，而每个文档都有的_id字段在你的User类中没有对应映射，因此抛出异常

解决方案 #

方案1：给实体类添加忽略多余字段特性 #

这是最简单的实现方式，直接在实体类上标注[BsonIgnoreExtraElements]，告诉驱动反序列化时自动忽略实体类中不存在的字段（包括自动生成的_id字段）

using MongoDB.Bson.Serialization.Attributes;

[BsonIgnoreExtraElements]
public class User 
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
}

方案2：通过类映射配置忽略多余字段 #

如果你不想给实体类添加MongoDB相关的特性侵入，可以在程序启动时全局配置类映射，仅需执行一次即可生效：

using MongoDB.Bson.Serialization;

BsonClassMap.RegisterClassMap<User>(cm => 
{
    cm.AutoMap(); // 自动映射实体类已有的字段
    cm.SetIgnoreExtraElements(true); // 忽略所有文档存在但实体类不存在的字段
});

如果需要给所有实体类全局生效，也可以配置全局序列化默认值：

MongoDefaults.IgnoreExtraElements = true;

方案3：指定业务字段作为主键（可选） #

如果你存在业务层面的唯一主键字段，可以给该字段标注[BsonId]特性，直接用业务字段替代MongoDB默认的ObjectId主键，也能解决映射不匹配的问题：

public class User 
{
    [BsonId]
    public string UserAccount { get; set; } // 用业务账号作为主键
    public string FirstName { get; set; }
    public string LastName { get; set; }
}

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