Include()方法影响EF查询结果：带关联查询返回0结果问题排查

阿华AIGC实验室

2026-5-12

问题分析与解决方案

这问题我之前排查过类似的，大概率是Include/ThenInclude里的关联数据配置或实际数据不匹配，导致EF Core生成的SQL用了INNER JOIN，把主表的Order记录给过滤掉了！

核心原因

你第一个查询var a = _context.Orders.FirstOrDefault(x => x.Id == OrderId);只查询Orders主表，不管关联表有没有数据，只要主表存在这条记录就能返回。

但加了OrdersFullInclude()之后，EF Core会为每个Include的导航属性生成JOIN语句：

如果某个导航属性（比如File、Company这类引用类型）被配置为必填（Required），EF Core会生成INNER JOIN；
一旦数据库中这条Order对应的该关联数据不存在（比如File为NULL），INNER JOIN就会把这条Order从结果集中排除，最终返回null。

举个例子：如果你的Order类里File属性加了[Required]特性，或者Fluent API配置了IsRequired()，但实际数据库中这条Order没有对应的File记录，那么包含Include(x => x.File)的查询就会因为INNER JOIN过滤掉这条Order。

验证方法

你可以输出两个查询的SQL语句对比，一眼就能看出问题：

// 输出第二个查询的SQL
var sql = _context.Orders.OrdersFullInclude().Where(x => x.Id == OrderId).ToQueryString();
Console.WriteLine(sql);

对比第一个查询的SQL，你会发现第二个查询多了多个INNER JOIN，只要其中一个JOIN的表没有匹配数据，结果就为空。

解决方案

针对不同情况，你可以采取以下措施：

1. 检查导航属性的必填配置

如果关联属性是可选的（允许为NULL）：

去掉数据注解中的[Required]特性：

public class Order
{
    public int Id { get; set; }
    // 去掉[Required]，用可空类型（C# 8+）
    public File? File { get; set; }
    public Company? Company { get; set; }
    // ...其他属性
}

或者在Fluent API中设置为可选：
```
modelBuilder.Entity<Order>()
    .HasOne(o => o.File)
    .WithOne()
    .IsRequired(false); // 明确标记为可选
```
这样EF Core会自动生成LEFT JOIN，即使关联表没有数据，主表的Order也会被返回。

2. 强制使用LEFT JOIN（特殊场景）

如果某些场景下你无法修改实体配置，可以尝试用Query方法手动构建LEFT JOIN（不过这种方式不如修改配置优雅）：

var b = _context.Orders
    .Where(x => x.Id == OrderId)
    .Select(o => new Order
    {
        Id = o.Id,
        // 手动关联，确保LEFT JOIN
        File = _context.Files.Where(f => f.OrderId == o.Id).FirstOrDefault(),
        StatusesHistory = _context.StatusHistories.Where(sh => sh.OrderId == o.Id).ToList(),
        // ...其他关联属性
    })
    .FirstOrDefault();