如何用C# MongoDB驱动+Linq实现类似EF的Include关联预加载？

首先得明确一点：MongoDB作为文档型数据库，本身不像关系型数据库那样有内置的关联加载机制，C#驱动也不会自动帮你跨集合拉取关联数据——这就是你拿到的Instance.Template始终为null的原因。不过我们有几种办法可以实现类似EF Include的预加载效果，下面分场景给你具体方案：

1. 简单场景：手动关联查询（适合单条数据查询） #

如果只是查询单个Instance，直接先查实例，再根据TemplateId拉取对应的Template就行，代码很直观：

// 获取实例集合
var instanceCollection = MongoDatabase.GetCollection<Instance>("Instances").AsQueryable();
var instance = instanceCollection.First(i => i.Id == 1);

// 如果有TemplateId，就去Templates集合查询并赋值
if (instance.TemplateId.HasValue)
{
    var templateCollection = MongoDatabase.GetCollection<Template>("Templates");
    instance.Template = templateCollection.Find(t => t.Id == instance.TemplateId.Value).FirstOrDefault();
}

这种方法简单直接，但如果要查询多条Instance，会出现N+1查询问题（查1次实例+N次模板），性能会受影响，这时候就需要用下面的批量方案。

2. 批量场景：用聚合Lookup实现关联查询（推荐） #

MongoDB的聚合管道提供了$lookup操作，相当于关系数据库的左连接，可以一次性把关联的Template数据拉回来，再映射到Instance的属性上。

方式一：直接使用聚合管道语法 #

var instanceCollection = MongoDatabase.GetCollection<Instance>("Instances");

var pipeline = new BsonDocument[]
{
    // 先匹配目标Instance
    new BsonDocument("$match", new BsonDocument("Id", 1)),
    // 关联Templates集合：根据Instance.TemplateId匹配Template.Id
    new BsonDocument("$lookup", new BsonDocument
    {
        { "from", "Templates" },       // 关联的集合名
        { "localField", "TemplateId" },// 当前集合的关联字段
        { "foreignField", "Id" },      // 目标集合的关联字段
        { "as", "Template" }           // 结果存储的字段名（默认是数组）
    }),
    // 因为TemplateId对应唯一的Template，把数组转成单个对象
    new BsonDocument("$addFields", new BsonDocument("Template", new BsonDocument("$arrayElemAt", new BsonArray { "$Template", 0 })))
};

// 执行聚合查询，得到带Template的Instance
var instanceWithTemplate = instanceCollection.Aggregate<Instance>(pipeline).FirstOrDefault();

方式二：用Linq语法更贴合C#习惯 #

如果你更喜欢Linq的写法，MongoDB驱动也支持将Linq查询转换为$lookup聚合操作：

var instanceCollection = MongoDatabase.GetCollection<Instance>("Instances").AsQueryable();
var templateCollection = MongoDatabase.GetCollection<Template>("Templates").AsQueryable();

var query = from instance in instanceCollection
            where instance.Id == 1
            // 关联Templates集合
            join template in templateCollection
            on instance.TemplateId equals template.Id into joinedTemplates
            // 构造新的Instance对象，把关联的Template赋值进去
            select new Instance
            {
                Id = instance.Id,
                Name = instance.Name,
                TemplateId = instance.TemplateId,
                Template = joinedTemplates.FirstOrDefault()
            };

var instanceWithTemplate = query.FirstOrDefault();

3. 批量查询优化：避免N+1的手动映射 #

如果需要查询一批Instance，还可以先批量拉取所有实例，收集所有需要的TemplateId，再一次性拉取所有模板，最后手动映射到对应的实例上，这种方式性能也很好：

// 1. 查询一批Instance
var instances = instanceCollection.Find(i => i.Id.In(new[] {1,2,3})).ToList();

// 2. 收集所有非空的TemplateId并去重
var templateIds = instances
    .Where(i => i.TemplateId.HasValue)
    .Select(i => i.TemplateId.Value)
    .Distinct()
    .ToList();

// 3. 一次性拉取所有需要的Template，转成字典方便查找
var templateDict = templateCollection
    .Find(t => t.Id.In(templateIds))
    .ToList()
    .ToDictionary(t => t.Id);

// 4. 手动给每个Instance赋值Template
foreach (var instance in instances)
{
    if (instance.TemplateId.HasValue)
    {
        templateDict.TryGetValue(instance.TemplateId.Value, out var template);
        instance.Template = template;
    }
}

额外建议：考虑MongoDB的文档设计特性 #

MongoDB是文档数据库，如果你的业务场景中Template不是被大量Instance共享，或者不需要独立更新，把Template作为嵌入式文档直接存在Instance里会更高效——这样查询Instance时就能直接拿到Template数据，完全不需要跨集合关联：

// 修改Instance类，把Template内嵌进去
public class Instance { 
    public int Id { get; set; } 
    public string Name { get; set; } 
    // 可以去掉TemplateId，直接存Template对象
    public Template Template { get; set; } 
} 

// 这样查询时直接就能拿到Template，不需要额外操作
var instance = instanceCollection.First(i => i.Id == 1);
var template = instance.Template; // 不再为null

当然，如果Template需要被多个Instance共享，或者需要独立维护，那分开两个集合是更合理的选择。

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