MongoDB C#驱动通过UUID查询文档失败问题求助

问题背景 #

用C#编写API查询MongoDB中的Minecraft账号数据，查询其他属性均正常，但通过UUID（_id字段）始终无法查到文档。已知MongoDB中_id存储的是标准UUID（类型4），已尝试将C# Guid转为标准格式的BsonBinaryData查询，但无效。

用到的查询代码：

public async Task<User> Get(Guid uuid) {
    BsonBinaryData binUuid = new BsonBinaryData(uuid, GuidRepresentation.Standard);
    return await users.Find(Builders<User>.Filter.Eq("_id", binUuid)).FirstOrDefaultAsync<User>();
}

User模型定义：

public class User {
    public Guid Id {get; set;}
    public string? data {get; set;}
    public string? lastKnownName {get; set;}
    public SkinBlob? lastKnownSkin {get; set;}
    public DateTime? lastOnline {get; set;}
    public DateTime? firstJoin {get; set;}
    public string? maskRank {get; set;}
    public string? maskName {get; set;}
    public SkinBlob? maskSkin {get; set;}
    public string? disguise {get; set;}
    public PermissionInfo? permissionInfo {get; set;}
}

解决步骤 #

1. 全局配置MongoDB驱动的Guid表示方式 #

仅在查询时单独指定GuidRepresentation.Standard不够，驱动默认可能使用Legacy格式，导致序列化/反序列化不匹配。初始化MongoClient时需全局设置：

var settings = MongoClientSettings.FromConnectionString("你的MongoDB连接字符串");
settings.GuidRepresentation = GuidRepresentation.Standard;
var client = new MongoClient(settings);

2. 给实体类Id字段显式配置映射和Guid格式 #

虽然MongoDB默认会把Id映射到_id，但显式添加特性可避免歧义，同时强制指定存储格式：

public class User {
    [BsonId]
    [BsonGuidRepresentation(GuidRepresentation.Standard)]
    public Guid Id {get; set;}
    // 其他属性保持不变
}

3. 简化查询代码，让驱动自动处理转换 #

无需手动转换BsonBinaryData，直接用Guid构造过滤器即可，驱动会根据配置自动处理格式转换：

public async Task<User> Get(Guid uuid) {
    return await users.Find(Builders<User>.Filter.Eq(u => u.Id, uuid)).FirstOrDefaultAsync<User>();
}

4. 验证MongoDB中的UUID存储格式 #

确认MongoDB Compass中_id的二进制子类型为0x04（Standard UUID），若存储时使用其他格式，需统一为Standard类型才能匹配。

额外排查点 #

• 检查传入的uuid参数值是否正确，有无大小写错误或多余连字符；
• 在MongoDB Compass中直接执行查询{"_id": UUID("你的UUID字符串")}，验证数据本身可被查到。

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