EF Core原生SQL关联查询如何仅返回指定所需字段

你定义了两个存在外键关联的实体类，Book通过AuthorID字段关联Author的主键ID：

public class Book
{
    public int ID { get; set; }
    public string Name { get; set; }
    public DateTime Date { get; set; }
    public int AuthorID { get; set; }

    public Author author { get; set; }
}

public class Author
{
    public int ID { get; set; }
    public string Name { get; set; }
    public DateTime BirthDate { get; set; }
    public string Place { get; set; }
}

使用LINQ投影查询时，可以做到仅加载需要的字段，不查询Author的BirthDate、Place等冗余属性，示例代码如下：

var _book = context.Book
    .Where(x => x.ID == ID_I_Pass_From_FrontEnd)
    .Select(x => new Book {
        ID = x.ID, 
        Name = x.Name,
        Date = x.Date, 
        author = new Author {ID = x.author.ID, Name = x.author.Name}
    })
    .FirstOrDefault();

出于性能考虑，你希望改用原生SQL实现同等效果，最初编写的代码如下：

var sql = string.Format("SELECT * FROM[Book] AS[x] WHERE([x].ID == ({0})), ID_I_Pass_From_FrontEnd");
var result = context.Book.FromSql(sql).Include(x => x.author).FirstOrDefault();

该写法存在明显缺陷：会加载Author实体的所有字段，返回大量非必要数据（实际业务场景下实体字段远多于示例，性能损耗明显）。你曾尝试直接在SQL中写INNER JOIN关联Author表，运行抛出错误Sequence contains more than one matching element，初步判断是两张表存在ID等同名字段，导致EF Core映射冲突。

其他运行环境与诉求：

• 数据库使用Azure SQL
• 核心目标：通过原生SQL实现字段裁剪，仅返回业务需要的属性，避免非必要字段加载。

问题根因 #

首先明确三个常见误区：

• 只要使用Include()方法加载导航属性，EF Core就会自动查询该关联实体配置的所有映射字段，无法实现字段裁剪。
• 直接JOIN两张表时如果不处理同名列，结果集中会出现多个同名的ID、Name列，EF Core无法识别列归属的实体/导航属性，就会抛出匹配重复的错误。
• 原始代码中的SQL存在语法错误：SQL Server中相等判断使用单等号=而非C#的双等号==；另外使用string.Format拼接前端传入的参数存在严重SQL注入风险，必须使用参数化查询。

实现方式（无冗余字段、无映射冲突） #

最稳妥的方案是通过扁平化DTO中转查询结果，完全自主控制返回字段，彻底避免列名冲突问题，步骤如下：

1. 定义和查询返回字段一一对应的DTO类，从根源上避免同名列冲突：

public class BookQueryDto
{
    public int BookID { get; set; }
    public string BookName { get; set; }
    public DateTime BookPublishDate { get; set; }
    public int AuthorFK { get; set; }
    public int AuthorID { get; set; }
    public string AuthorName { get; set; }
}

2. 在DbContext中为该DTO配置无键实体映射（EF Core 2.1+版本支持）：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<BookQueryDto>().HasNoKey().ToView(null);
    // 其余原有实体配置保持不变
}

3. 编写原生SQL查询，仅返回需要的字段，给列起和DTO属性一致的别名，使用参数化传参：

// 定义参数，避免SQL注入
var bookIdParam = new SqlParameter("@targetBookId", ID_I_Pass_From_FrontEnd);
var querySql = @"
    SELECT
        b.ID AS BookID,
        b.Name AS BookName,
        b.Date AS BookPublishDate,
        b.AuthorID AS AuthorFK,
        a.ID AS AuthorID,
        a.Name AS AuthorName
    FROM Book b
    INNER JOIN Author a ON b.AuthorID = a.ID
    WHERE b.ID = @targetBookId
";
// 执行查询
var queryResult = context.Set<BookQueryDto>()
    .FromSqlRaw(querySql, bookIdParam)
    .FirstOrDefault();

4. 将查询结果映射为你需要的Book实体结构即可：

if (queryResult == null)
{
    // 处理书籍不存在的业务逻辑
    return null;
}
var targetBook = new Book
{
    ID = queryResult.BookID,
    Name = queryResult.BookName,
    Date = queryResult.BookPublishDate,
    AuthorID = queryResult.AuthorFK,
    author = new Author
    {
        ID = queryResult.AuthorID,
        Name = queryResult.AuthorName
        // BirthDate、Place字段不会被查询和赋值，无冗余加载
    }
};

该方案的优势：

• 完全由你控制SQL逻辑和返回字段，不会加载任何非必要列，性能和纯手写SQL执行效率完全一致
• 不存在列名映射冲突问题，字段别名和DTO属性一一对应，不会出现EF Core映射错误
• 完全规避SQL注入风险
• 原生适配Azure SQL（SQL Server语法），不需要额外调整兼容配置。

如果你不想额外定义DTO，也可以在编写JOIN SQL时，给导航属性对应的字段加[导航属性名]前缀作为别名（比如Author的ID别名为authorID、Name别名为authorName），去掉Include()直接用FromSqlRaw查询Book实体，EF Core可以自动识别前缀匹配导航属性，但这种方式对EF Core的版本和映射配置有要求，出现映射问题时排查成本更高，更推荐DTO中转的方案。

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