EF Core 5.0.3 懒加载导航属性时如何自动加载完整对象图

EF Core的ILazyLoader默认只会加载当前触发访问的导航属性，不会递归加载关联实体的子导航，所以懒加载出Post集合后，Post的Author、Category不会被自动填充。
不需要大范围改动现有代码，也不需要给Post的所有导航属性配置懒加载，直接在DbContext层拦截懒加载行为即可，核心是自定义ILazyLoader装饰器，对特定导航的懒加载逻辑追加自动预加载关联属性的逻辑。

具体实现步骤 #

• 第一步：编写ILazyLoader装饰器，包装EF Core原生的懒加载实现，在检测到目标导航（即Blog.Posts）加载完成后，自动补加载Post类下需要的关联属性

public class CustomLazyLoader : ILazyLoader
{
    private readonly ILazyLoader _defaultLoader;
    private readonly DbContext _dbContext;

    public CustomLazyLoader(ILazyLoader defaultLoader, DbContext dbContext)
    {
        _defaultLoader = defaultLoader;
        _dbContext = dbContext;
    }

    public void Load(object sourceEntity, string navigationPropertyName)
    {
        // 执行原生懒加载逻辑
        _defaultLoader.Load(sourceEntity, navigationPropertyName);

        // 仅当触发Blog的Posts集合懒加载时，追加加载Post的关联导航
        if (sourceEntity is Blog && navigationPropertyName == nameof(Blog.Posts))
        {
            _dbContext.Entry((Blog)sourceEntity)
                .Collection(b => b.Posts)
                .Query()
                .Include(p => p.Author)
                .Include(p => p.Category)
                .Load();
        }
    }

    public async Task LoadAsync(object sourceEntity, string navigationPropertyName, CancellationToken token = default)
    {
        await _defaultLoader.LoadAsync(sourceEntity, navigationPropertyName, token);
        
        if (sourceEntity is Blog && navigationPropertyName == nameof(Blog.Posts))
        {
            await _dbContext.Entry((Blog)sourceEntity)
                .Collection(b => b.Posts)
                .Query()
                .Include(p => p.Author)
                .Include(p => p.Category)
                .LoadAsync(token);
        }
    }
}

• 第二步：在DbContext中替换默认ILazyLoader实现，不需要修改上层仓储的任何代码

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    // 保留原有数据库连接、其他基础配置
    optionsBuilder
        .ReplaceService<ILazyLoader, CustomLazyLoader>();
}

EF Core内部服务容器会自动解析当前DbContext实例注入到CustomLazyLoader构造函数中，不需要额外配置服务生命周期。如果需要加载更深层级的对象图，直接在Query()后追加Include/ThenInclude即可。

方案优势 #

• 零侵入上层业务、仓储代码：所有逻辑都收敛在DbContext内部，不需要修改仓储抽象、不需要调整现有业务查询逻辑
• 不需要修改Post类定义：不用给Post加ILazyLoader字段、不用改造Author/Category导航属性的get/set逻辑，保持Post类的简洁
• 加载范围可控：仅当通过Blog.Posts触发懒加载时才会自动加载Post的关联属性，其他场景下单独查询Post不会产生额外的查询开销

备选轻量方案（不推荐） #

如果不想自定义ILazyLoader，也可以在DbContext构造函数中订阅ChangeTracker的Tracked事件，当检测到Post实体被上下文追踪时，自动加载其Author、Category属性：

public YourDbContext(DbContextOptions<YourDbContext> options) : base(options)
{
    ChangeTracker.Tracked += (s, e) =>
    {
        if (e.Entry.Entity is Post p)
        {
            e.Entry.Reference(p => p.Author).Load();
            e.Entry.Reference(p => p.Category).Load();
        }
    };
}

该方案的缺点是无法区分Post实体是通过Blog.Posts懒加载进来的，还是通过其他业务查询主动追踪的，会在所有Post被追踪的场景都触发额外查询，容易产生不必要的性能开销，仅适合对性能要求不高的小型项目使用。

注意事项 #

如果单篇Blog关联Post数量较多，建议评估自动Include的性能开销，可按需给追加的查询加过滤条件，避免单次拉取数据量过大。

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