ASP.NET Boilerplate 性能优化指南：三大维度提升 EF Core 查询效率

2026-04-21 09:42:06作者：咎岭娴Homer

ASP.NET Boilerplate 是一个开源的 ASP.NET Core 应用程序框架，提供了丰富的功能和模块。本指南将从数据访问层优化、查询逻辑优化和架构层优化三个维度，帮助开发者解决 EF Core（对象关系映射框架）查询性能问题，提升应用响应速度和吞吐量。

一、诊断性能瓶颈：从慢查询分析入手

在进行性能优化前，准确识别瓶颈是关键。ASP.NET Boilerplate 提供了多种工具和方法来诊断 EF Core 查询性能问题。

启用详细日志记录

通过配置 DbContext 日志记录，捕获 EF Core 生成的 SQL 语句和执行时间。

// 优化前：默认配置，无法获取详细查询信息
services.AddDbContext<MyDbContext>(options =>
    options.UseSqlServer(Configuration.GetConnectionString("Default")));

// 优化后：启用详细日志和敏感数据记录
services.AddDbContext<MyDbContext>(options =>
    options.UseSqlServer(Configuration.GetConnectionString("Default"))
           .UseLoggerFactory(loggerFactory)
           .EnableSensitiveDataLogging()
           .EnableDetailedErrors());

原理简析：EF Core 的日志记录功能可以输出生成的 SQL 语句、参数值和执行时间，帮助定位慢查询。

使用数据库分析工具

结合数据库自带的性能分析工具，如 SQL Server 的 Profiler 或 MySQL 的 Slow Query Log，识别执行效率低的查询语句。

常见误区

过度依赖 ORM 自动生成的 SQL：EF Core 生成的 SQL 不一定最优，特别是在复杂查询场景下。
忽略查询执行计划：未分析查询执行计划，导致无法发现索引缺失等问题。

二、优化查询逻辑：提升数据访问效率

选择性加载数据：避免过度查询

只查询需要的字段，减少数据传输量和内存占用。

// 优化前：加载整个实体
var orders = await _orderRepository.GetAll()
    .Where(o => o.CustomerId == customerId)
    .ToListAsync();

// 优化后：只选择必要字段
var orderSummaries = await _orderRepository.GetAll()
    .Where(o => o.CustomerId == customerId)
    .Select(o => new OrderSummaryDto
    {
        Id = o.Id,
        OrderDate = o.OrderDate,
        TotalAmount = o.TotalAmount,
        Status = o.Status
    })
    .ToListAsync();

原理简析：通过投影（Projection）只获取需要的字段，减少数据库查询返回的数据量，降低网络传输和内存消耗。

智能导航属性加载：解决 N+1 查询问题

合理使用 Include 和 ThenInclude 方法，避免不必要的关联数据加载。

// 优化前：可能导致 N+1 查询问题
var orders = await _orderRepository.GetAll()
    .Include(o => o.OrderItems)
    .ToListAsync();

// 优化后：条件性包含导航属性
var orders = await _orderRepository.GetAll()
    .IncludeIf(includeItems, o => o.OrderItems)
    .IncludeIf(includeCustomer, o => o.Customer)
    .ThenInclude(c => c.Address)
    .ToListAsync();

原理简析：IncludeIf 方法允许根据条件动态包含导航属性，避免加载不需要的关联数据，减少数据库联接操作。

分页查询优化：减少数据处理量

对大数据集查询实施分页，只加载当前页所需数据。

// 优化前：加载所有数据再分页
var allOrders = await _orderRepository.GetAll().ToListAsync();
var pagedOrders = allOrders.Skip((pageIndex - 1) * pageSize).Take(pageSize).ToList();

// 优化后：数据库层面分页
var pagedOrders = await _orderRepository.GetAll()
    .OrderByDescending(o => o.OrderDate)
    .Skip((pageIndex - 1) * pageSize)
    .Take(pageSize)
    .ToListAsync();

原理简析：在数据库层面进行分页，减少从数据库传输到应用程序的数据量，提高查询效率。

常见误区

滥用 Include 方法：加载所有关联数据，导致查询效率低下。
忽略排序：未对分页查询进行排序，可能导致结果不一致。

三、优化数据访问层：提升整体性能

使用无跟踪查询：减少内存开销

在只读查询场景中，使用 AsNoTracking 方法或 GetAllReadonly 方法，避免 EF Core 的变更跟踪开销。

// 优化前：默认跟踪查询
var products = await _productRepository.GetAll()
    .Where(p => p.IsActive)
    .ToListAsync();

// 优化后：无跟踪查询
var products = await _productRepository.GetAllReadonly()
    .Where(p => p.IsActive)
    .ToListAsync();

原理简析：无跟踪查询不会对实体进行变更跟踪，减少内存占用和 CPU 开销，适合只读场景。

批量操作优化：减少数据库往返

使用批量操作代替循环单个操作，减少数据库往返次数。

// 优化前：循环单个删除
foreach (var expiredOrder in expiredOrders)
{
    await _orderRepository.DeleteAsync(expiredOrder);
}

// 优化后：批量删除
await _orderRepository.DeleteAsync(o => o.OrderDate < DateTime.Now.AddMonths(-12));

原理简析：批量操作可以在一次数据库往返中处理多个实体，减少网络开销和数据库连接占用时间。

索引优化：提升查询速度

为频繁查询的字段创建适当的索引，提高查询效率。

// 在实体类中配置索引
[Table("Orders")]
public class Order
{
    [Key]
    public int Id { get; set; }
    
    [Index]
    public DateTime OrderDate { get; set; }
    
    [Index]
    public int CustomerId { get; set; }
    
    // 其他属性...
}

原理简析：索引可以加快查询速度，特别是在大数据集上。合理的索引设计可以显著提升查询性能。

常见误区

过度索引：创建过多索引会影响插入、更新和删除操作的性能。
忽略复合索引：对于多条件查询，复合索引比单个字段索引更有效。

四、进阶技巧：高级性能优化方法

查询编译：提升重复查询性能

使用 EF Core 的查询编译功能，缓存查询计划，提升重复查询的性能。

// 定义编译查询
private static readonly Func<MyDbContext, int, Task<Order>> _getOrderByIdQuery =
    EF.CompileAsyncQuery((MyDbContext context, int id) =>
        context.Orders.FirstOrDefault(o => o.Id == id));

// 使用编译查询
var order = await _getOrderByIdQuery(_dbContext, orderId);

原理简析：编译查询会预先生成查询计划并缓存，避免每次执行查询时重新解析和编译，提升查询性能。

二级缓存：减少数据库访问

使用二级缓存存储频繁访问的数据，减少数据库查询次数。

// 配置二级缓存
services.AddAbpDbContext<MyDbContext>(options =>
{
    options.DbContextOptions.UseSqlServer(Configuration.GetConnectionString("Default"));
    options.AddDefaultRepositories(includeAllEntities: true);
})
.AddCacheableRepositories();

// 使用缓存仓储
var cachedProducts = await _productRepository.GetAll()
    .Cacheable(TimeSpan.FromMinutes(10))
    .ToListAsync();

原理简析：二级缓存可以将查询结果存储在内存中，对于频繁访问且不常变化的数据，可显著减少数据库访问次数。