EF Core延迟加载怎么用 EF Core Lazy Loading配置方法

月夜之吻 2025-12-25 00:00:00 次阅读

EF Core 默认不启用延迟加载，需安装 Microsoft.EntityFrameworkCore.Proxies 包、调用 UseLazyLoadingProxies() 启用代理、并将导航属性声明为 virtual；替代方案是通过 ILazyLoader 注入实现无代理延迟加载，但推荐优先使用 Include/ThenInclude 显式加载以避免 N+1 问题。

EF Core 默认不启用延迟加载，要用它得手动配三样东西：装包、启代理、标 virtual。核心就一句话——访问导航属性时才查数据库，但容易引发 N+1 查询，生产环境慎用。

安装 Microsoft.EntityFrameworkCore.Proxies 包

这是启用延迟加载的前提，没有它，UseLazyLoadingProxies() 方法根本不存在。

用 NuGet 命令安装：Install-Package Microsoft.EntityFrameworkCore.Proxies
或在 .csproj 文件中添加引用：（版本建议匹配你当前 EF Core 版本）

在 DbContext 中启用代理支持

必须显式调用 UseLazyLoadingProxies()，否则即使实体标了 virtual 也无效。

在 OnConfiguring 中配置（适合简单场景）：

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
  optionsBuilder
    .UseSqlServer("YourConnectionString")
    .UseLazyLoadingProxies();
}

在 ASP.NET Core 的 Program.cs 或 Startup.cs 中配置（推荐）：

builder.Services.AddDbContext(options =>
  options.UseSqlServer(connectionString)
    .UseLazyLoadingProxies());

实体导航属性必须声明为 virtual

EF Core 需要通过运行时生成代理子类来拦截属性访问，只有 virtual 成员才能被重写。

集合导航属性示例：public virtual ICollection Posts { get; set; }
引用导航属性示例：public virtual Blog Blog { get; set; }
注意：不能是 private set 或 init，getter/setter 都得可重写；初始化如 = new List() 可以保留，不影响延迟逻辑

替代方案：不用代理也能延迟加载（ILazyLoader 注入）

适合不想依赖代理、或需更精细控制加载时机的场景。原理是把加载逻辑交给构造函数注入的 ILazyLoader 实例。

实体需提供带 ILazyLoader 的构造函数，并用它加载私有字段：

public class Blog
{
  private readonly ILazyLoader _lazyLoader;
  private ICollection _posts;

  public Blog(ILazyLoader lazyLoader) => _lazyLoader = lazyLoader;

  public virtual ICollection Posts
    => _lazyLoader.Load(this, ref _posts);
}