基类含BsonId属性时，派生类能否使用Id属性？

这个错误的核心原因很明确：MongoDB的Bson序列化规则里，默认会把名为Id的属性自动映射到文档的_id字段，而你的基类BaseWithoutId已经通过[BsonId]特性将IdForMongo属性绑定到了_id字段，两者争抢同一个_id元素名，自然就抛出冲突错误了。

而DerivedWithoutId能正常运行的原因是，基类BaseWithId中已经存在Id属性，序列化时它会被默认映射到Id元素（而非_id），和基类的IdForMongo（绑定_id）互不干扰。

下面提供两种可行的解决方案：

方案1：给派生类的Id属性指定自定义元素名 #

直接通过[BsonElement]特性给派生类的Id属性指定一个不和_id重复的元素名，比如"id"或者"entity_id"：

public class DerivedWithId : BaseWithoutId
{
    [BsonElement("id")] // 指定自定义元素名，避开_id
    public Guid Id { get; set; }
    public string Description { get; set; }
}

这样序列化后，派生类的Id会被存储为文档中的id字段，和基类的IdForMongo对应的_id字段完全分离，不会再有冲突。

方案2：调整基类的BsonId映射规则 #

如果你希望派生类的Id属性作为文档的_id字段，那需要修改基类的IdForMongo的元素名，让它让出_id。可以通过BsonClassMap手动注册类映射来实现：

在程序启动初期（比如Main方法开头）添加以下配置：

// 配置基类，将IdForMongo映射到自定义元素名
BsonClassMap.RegisterClassMap<BaseWithoutId>(cm =>
{
    cm.AutoMap();
    // 把基类的IdForMongo映射到"id_for_mongo"，而非默认的_id
    cm.MapIdMember(c => c.IdForMongo).SetElementName("id_for_mongo");
});

// 配置派生类，让Id属性映射到_id
BsonClassMap.RegisterClassMap<DerivedWithId>(cm =>
{
    cm.AutoMap();
    cm.MapMember(c => c.Id).SetElementName("_id");
});

这样配置后，基类的IdForMongo会对应文档的id_for_mongo字段，派生类的Id对应_id字段，冲突问题就解决了。

需要注意的是，如果你选择这种方案，所有继承BaseWithoutId的类都会受到这个映射规则的影响，要确保这符合你的整体数据模型设计。

内容的提问来源于stack exchange，提问作者Mikael Egnér