深入解析 Entity Framework Core 的三种数据加载策略
在 Entity Framework Core (EF Core) 中,处理实体间的关联关系时,数据加载机制是性能调优和架构设计的核心环节。EF Core 提供了三种主要的数据加载模式:预加载(Eager Loading)、显式加载(Explicit Loading)和延迟加载(Lazy Loading)。合理选择加载策略能够有效减少数据库往返次数并降低内存消耗。
1. 预加载 (Eager Loading)
预加载是指在查询主实体时,通过单次数据库查询将相关的关联数据一并检索出来。这种方式能够避免 N+1 查询问题,但如果关联层级过深或数据量过大,可能会导致加载大量当前业务并不需要的冗余数据,从而影响查询性能。
在 EF Core 中,预加载主要通过 Include() 和 ThenInclude() 扩展方法来实现。
/// <summary>
/// 获取订单及其明细和对应的商品信息
/// </summary>
public async Task<Order> GetOrderWithDetailsAsync(int orderId, CancellationToken token = default)
{
return await _dbContext.Orders
.Where(order => order.Id == orderId)
.Include(order => order.OrderItems)
.ThenInclude(item => item.Product)
.FirstOrDefaultAsync(token);
}
2. 显式加载 (Explicit Loading)
显式加载允许开发者在主实体已经被查询出来后,根据实际业务逻辑按需加载其导航属性。这种方式提供了极高的灵活性,适合在运行时动态决定是否加载关联数据。对于集合类型的导航属性,使用 Collection() 方法;对于单一引用类型的导航属性,则使用 Reference() 方法。
// 1. 首先查询主实体
var targetOrder = await _dbContext.Orders.FirstOrDefaultAsync(o => o.Id == orderId);
if (targetOrder != null)
{
// 2. 显式加载集合类型的导航属性 (订单明细)
await _dbContext.Entry(targetOrder)
.Collection(order => order.OrderItems)
.LoadAsync();
// 3. 显式加载引用类型的导航属性 (客户信息)
await _dbContext.Entry(targetOrder)
.Reference(order => order.Customer)
.LoadAsync();
}
3. 延迟加载 (Lazy Loading)
延迟加载(又称懒加载)是指在代码中首次访问实体的导航属性时,EF Core 才会自动向数据库发送查询以加载相关数据。这种模式在编写代码时最为简洁,但如果不加以控制,极易引发严重的 N+1 查询问题,导致数据库连接池耗尽或响应时间剧增。
EF Core 默认并未内置延迟加载功能,需要通过 NuGet 安装 Microsoft.EntityFrameworkCore.Proxies 包来提供动态代理支持。
配置延迟加载
启用延迟加载可以通过依赖注入(DI)配置,或者在 DbContext 的 OnConfiguring 方法中进行设置。
方式一:在依赖注入中配置
builder.Services.AddDbContext<AppDbContext>(options =>
{
options.UseLazyLoadingProxies()
.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection"));
});
方式二:在 DbContext 中重写 OnConfiguring
protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
if (!optionsBuilder.IsConfigured)
{
optionsBuilder.UseLazyLoadingProxies()
.UseSqlServer("Server=.;Database=AppDb;Trusted_Connection=True;");
}
}
实体类定义要求
要使延迟加载生效,实体类中的导航属性必须满足特定条件:属性必须是 public 的,并且必须使用 virtual 关键字进行修饰,以便 EF Core 能够生成动态代理类来拦截属性访问。
public class Blog
{
public int Id { get; set; }
public string Name { get; set; }
public string Description { get; set; }
// 集合导航属性必须标记为 virtual
public virtual ICollection<Post> Posts { get; set; } = new List<Post>();
// 引用导航属性也必须标记为 virtual
public virtual BlogSetting Setting { get; set; }
}