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 ICollectionPosts { 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 ICollectionPosts
=> _lazyLoader.Load(this, ref _posts);
}
- 该方式无需
virtual属性(但仍需virtualgetter 以支持代理机制兼容),也不依赖动态代理,更可控,但代码稍多
基本上就这些。配置不复杂但容易忽略细节,比如漏装包、忘加 virtual、或在上下文已释放后访问导航属性导致异常。真要兼顾性能和可维护性,多数场景建议优先用 Include + ThenInclude 显式加载。










