.NET Core中MongoDB.Driver映射POCO时ObjectId为空的问题

针对你使用MongoDB.Driver 2.13.0时遇到的DBRef字段（RR4NFAD）Id映射问题，以下是可行的解决方案：

1. 正确定义DBRef对应的POCO类 #

MongoDB的DBRef结构包含$ref、$db、$id三个核心字段，需要在POCO类中准确映射这些字段，并指定$id的序列化规则：

public class RR4NFADRef
{
    [BsonElement("$ref")]
    public string CollectionRef { get; set; }

    [BsonElement("$db")]
    public string DatabaseName { get; set; }

    [BsonElement("$id")]
    [BsonSerializer(typeof(ObjectIdSerializer))]
    public ObjectId DocumentId { get; set; }
}

在主实体类中引用该DBRef类：

public class YourMainEntity
{
    public ObjectId Id { get; set; }

    public RR4NFADRef RR4NFAD { get; set; }

    // 其他业务属性
}

2. 注册类映射（可选但推荐） #

如果驱动自动映射出现问题，可手动注册类映射确保字段匹配：

// 在项目初始化时（如Startup.cs的ConfigureServices中）执行
BsonClassMap.RegisterClassMap<RR4NFADRef>(map =>
{
    map.AutoMap();
    map.MapField(refField => refField.CollectionRef).SetElementName("$ref");
    map.MapField(dbField => dbField.DatabaseName).SetElementName("$db");
    map.MapField(idField => idField.DocumentId)
        .SetElementName("$id")
        .SetSerializer(new ObjectIdSerializer());
});

3. 处理字符串类型的$id字段 #

如果MongoDB文档中$id存储的是字符串格式的ObjectId（而非原生ObjectId类型），需要添加[BsonRepresentation]属性实现自动转换：

[BsonElement("$id")]
[BsonRepresentation(BsonType.ObjectId)]
public ObjectId DocumentId { get; set; }

4. 查询关联文档 #

获取到正确的ObjectId后，即可正常查询关联集合的文档：

// 假设关联集合的实体为RelatedEntity
var filter = Builders<RelatedEntity>.Filter.Eq(e => e.Id, mainEntity.RR4NFAD.DocumentId);
var relatedDoc = await _relatedCollection.Find(filter).FirstOrDefaultAsync();

常见问题排查 #

• 检查MongoDB文档中$id的实际类型：使用MongoDB Compass查看字段类型，若为字符串则需启用BsonRepresentation转换。
• 避免自定义转换器的错误：若之前自定义了ObjectId转换器，确保其正确实现了IBsonSerializer<ObjectId>的反序列化逻辑，不要覆盖驱动默认的序列化规则。

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