EF Core 如何实现带OR连接条件的左外连接并保留全部主表数据

首先明确核心前提：LINQ 原生查询语法的join子句本身仅支持等值连接的ON条件判定，无法直接嵌入OR逻辑，这是查询语法的设计约束，并非EF Core的能力限制。要实现带OR连接谓词的左外连接、保证Table1的全量行不丢失，可采用以下两种经过生产验证的写法：

方法1：GroupJoin 内联OR过滤（EF Core 5.0+ 最优写法） #

EF Core 5.0及以上版本支持将Join谓词内联的过滤逻辑自动优化为原生LEFT OUTER JOIN的ON条件，是最贴合需求的实现方式，生成的SQL和手写的原生查询逻辑完全一致。
示例代码：

var result = db.Table1s
    .GroupJoin(
        // 关联的从表集合
        db.Table2s,
        // 主表键选择器（因存在OR逻辑，无法构造等值匿名键，直接传递实体即可）
        t1 => t1,
        // 从表键选择器
        t2 => t2,
        // 关联结果投影
        (t1, t2AllMatches) => new
        {
            MainRow = t1,
            // 对关联到的从表集合做OR条件过滤
            MatchedRows = t2AllMatches.Where(t2 => 
                t1.Id == t2.ParentId || t1.Id2 == t2.ParentId2
            )
        })
    // 将嵌套的匹配集合展开为扁平结果，配合DefaultIfEmpty保留无匹配的主表行
    .SelectMany(
        joinSet => joinSet.MatchedRows.DefaultIfEmpty(),
        (joinSet, t2) => new
        {
            joinSet.MainRow,
            MatchedTable2 = t2
        })
    .ToList();

该写法生成的原生SQL结构完全匹配预期：

• 主表Table1的所有行都会被返回，不会因为没有匹配的Table2数据被过滤
• 连接ON条件完全按照OR逻辑生成：ON t1.Id = t2.ParentId OR t1.Id2 = t2.ParentId2
• 无匹配关联的行，对应的Table2相关字段自动为null

方法2：低版本兼容写法 #

如果使用的EF Core版本低于5.0，无法将内联过滤逻辑优化为JOIN ON条件（会生成额外子查询导致性能下降），可以拆分为两次独立的等值左连接，最后合并去重：

// 第一次左连接：匹配 t1.Id = t2.ParentId 的关联关系
var joinById = db.Table1s
    .GroupJoin(
        db.Table2s,
        t1 => t1.Id,
        t2 => t2.ParentId,
        (t1, matches) => new
        {
            MainRow = t1,
            MatchedTable2 = matches.FirstOrDefault()
        });

// 第二次左连接：匹配 t1.Id2 = t2.ParentId2 的关联关系
var joinById2 = db.Table1s
    .GroupJoin(
        db.Table2s,
        t1 => t1.Id2,
        t2 => t2.ParentId2,
        (t1, matches) => new
        {
            MainRow = t1,
            MatchedTable2 = matches.FirstOrDefault()
        });

// 合并两次关联结果，按主表行去重，保留任意非空匹配值
var result = joinById
    .Concat(joinById2)
    .GroupBy(x => x.MainRow)
    .Select(g => new
    {
        Table1 = g.Key,
        MatchedTable2 = g.Select(x => x.MatchedTable2).FirstOrDefault(t2 => t2 != null)
    })
    .ToList();

注意：该写法适用于单主表行最多匹配1条从表数据的场景，如果是一对多关联，需要在合并时对所有匹配的从表行做去重处理，避免返回重复数据。

常见错误写法避坑 #

• 不要直接在LINQ查询语法的join子句中写OR逻辑：查询语法的join子句在编译期就强制要求ON条件为等值匹配，嵌入OR逻辑根本无法编译，不是EF Core不支持该语法。
• 不要用交叉连接加Where的写法：也就是from t1 in Table1 from t2 in Table2 where (t1.Id == t2.ParentId || t1.Id2 == t2.ParentId2)，这种写法本质是INNER JOIN，会直接丢失没有任何关联匹配的Table1行，完全不符合左连接的需求。
• 不要在DefaultIfEmpty展开后的Where子句中写关联判断：如果在from t2 in t2join.DefaultIfEmpty()之后再追加关联条件判断，会直接把左连接退化成内连接，同样会丢失无匹配的主表行。

内容的提问来源于stack exchange，提问作者Peter Kerr