EF Core中的N+1问题指的是在查询主实体集合后，遍历每个主实体去查询关联实体的场景，会产生1次主查询加N次关联查询，当主实体数量较多时，会大幅增加数据库请求次数，严重影响性能。
N+1问题的典型场景
假设我们有两个实体，一个是订单Order，一个是订单项OrderItem，一个订单包含多个订单项，实体定义如下：
public class Order
{
public int Id { get; set; }
public string OrderNo { get; set; }
public DateTime CreateTime { get; set; }
// 关联订单项集合
public List<OrderItem> OrderItems { get; set; }
}
public class OrderItem
{
public int Id { get; set; }
public string ProductName { get; set; }
public int Count { get; set; }
public decimal Price { get; set; }
// 关联订单
public int OrderId { get; set; }
public Order Order { get; set; }
}
如果我们需要查询所有订单，同时获取每个订单的订单项，错误的写法如下：
// 先查询所有订单，1次查询
var orders = dbContext.Orders.ToList();
// 遍历每个订单，查询对应的订单项，N次查询
foreach (var order in orders)
{
var items = dbContext.OrderItems.Where(item => item.OrderId == order.Id).ToList();
// 处理订单和订单项逻辑
}
当订单数量为100时，总共会产生101次数据库查询，这就是典型的N+1问题。
解决方法一：使用Include预加载
EF Core提供了Include方法，可以在查询主实体时一次性把关联的实体也加载出来，将N+1次查询合并为1次查询。
// 使用Include预加载关联的OrderItems，仅1次查询
var orders = dbContext.Orders
.Include(order => order.OrderItems)
.ToList();
foreach (var order in orders)
{
// 此时OrderItems已经被加载，不需要再发起查询
var items = order.OrderItems;
// 处理订单和订单项逻辑
}
如果有嵌套关联，比如订单项还关联了产品实体，可以使用ThenInclude继续加载：
var orders = dbContext.Orders
.Include(order => order.OrderItems)
.ThenInclude(item => item.Product)
.ToList();
解决方法二：使用显式加载
如果不需要在查询主实体时就加载所有关联数据，而是在后续需要的时候再按需加载，可以使用显式加载，避免不必要的关联数据查询。
var orders = dbContext.Orders.ToList();
foreach (var order in orders)
{
// 显式加载当前订单的订单项，仅当需要的时候才发起查询
dbContext.Entry(order)
.Collection(o => o.OrderItems)
.Load();
var items = order.OrderItems;
// 处理订单和订单项逻辑
}
如果只需要加载部分关联数据，还可以给显式加载添加过滤条件：
dbContext.Entry(order)
.Collection(o => o.OrderItems)
.Query()
.Where(item => item.Price > 100)
.Load();
解决方法三：使用拆分查询
当关联数据量较大时，使用Include生成的单条复杂SQL可能会导致性能下降，此时可以使用AsSplitQuery方法，将一次复杂查询拆分为多次简单查询，既避免N+1问题，又提升单条SQL的执行效率。
var orders = dbContext.Orders
.Include(order => order.OrderItems)
.AsSplitQuery()
.ToList();
此时EF Core会生成两条SQL，一条查询所有订单，一条查询所有关联的订单项，然后将结果自动关联起来，总共仅2次查询。
解决方法四：使用原始SQL查询
如果以上方法都无法满足性能要求，还可以直接编写原始SQL查询，手动控制查询逻辑，避免EF Core生成低效的SQL语句。
// 编写联表查询SQL，一次性获取订单和订单项数据
var sql = @"
SELECT o.Id, o.OrderNo, o.CreateTime,
i.Id AS ItemId, i.ProductName, i.Count, i.Price
FROM Orders o
LEFT JOIN OrderItems i ON o.Id = i.OrderId";
var orders = dbContext.Database.SqlQuery<OrderDto>(sql).ToList();
其中OrderDto是自定义的结果映射类，需要根据SQL查询的字段定义对应属性。
不同场景的方案选择
我们可以根据实际场景选择合适的解决方法：
- 如果需要查询主实体时就必须用到所有关联数据，优先选择
Include预加载，关联数据量不大时效率最高。 - 如果关联数据仅在部分分支逻辑中使用，优先选择显式加载，避免加载无用数据。
- 如果关联数据量较大，单条联表SQL性能较差，优先选择拆分查询。
- 如果查询逻辑非常复杂，EF Core生成的SQL无法满足性能要求，再考虑使用原始SQL查询。
另外，我们可以通过EF Core的日志记录功能，查看实际生成的SQL语句，快速识别是否存在N+1问题，及时优化查询逻辑。