EF Core列表查询忽略列，单条查询加载列的实现方案

你需要实现大字段（File）的按需加载，避免列表查询时加载不必要的二进制数据，同时在下载单条文件时能正常获取。以下是几种可行的实现方案：

方案一：投影查询（最直接的改动方式） #

列表查询时通过Select明确指定要加载的属性，排除File字段，避免加载二进制数据：

// 列表查询：只加载InvoiceFile的基础属性，不包含File
var invoices = await _payoutDbContext.Invoices
    .Select(inv => new Invoice
    {
        // 映射Invoice自身的所有必要属性，例如：
        Id = inv.Id,
        Number = inv.Number,
        // ...其他Invoice属性
        InvoiceFiles = inv.InvoiceFiles.Select(f => new InvoiceFile
        {
            Id = f.Id,
            FileName = f.FileName,
            InvoiceId = f.InvoiceId
            // 不映射File属性，避免加载二进制数据
        }).ToList()
    })
    .AsNoTracking()
    .ToListAsync();

下载单条文件时，直接查询完整的InvoiceFile实体：

var file = await _payoutDbContext.InvoiceFiles
    .Where(x => x.Id == invoiceFileId)
    .AsNoTracking()
    .FirstOrDefaultAsync();

注意：如果业务允许，建议使用DTO（数据传输对象）替代实体投影，比如创建InvoiceDto和InvoiceFileDto，更符合分层架构，也避免实体映射的潜在问题。

方案二：拆分实体（表拆分，EF Core 2.0+支持） #

将InvoiceFile拆分为两个实体，分别存储基础信息和文件内容，利用EF Core的表拆分特性共享同一张数据库表：

实体定义 #

public class InvoiceFile
{
    public Guid Id { get; set; }
    public string FileName { get; set; }

    public Guid InvoiceId { get; set; }
    public Invoice Invoice { get; set; }

    // 关联文件内容实体
    public InvoiceFileContent Content { get; set; }
}

public class InvoiceFileContent
{
    public Guid Id { get; set; }
    // 仅存储文件二进制数据
    public byte[] File { get; set; }

    public InvoiceFile InvoiceFile { get; set; }
}

Fluent配置（表拆分） #

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 两个实体映射到同一张表
    modelBuilder.Entity<InvoiceFile>()
        .ToTable("InvoiceFiles");

    modelBuilder.Entity<InvoiceFileContent>()
        .ToTable("InvoiceFiles")
        .HasOne(x => x.InvoiceFile)
        .WithOne(x => x.Content)
        .HasForeignKey<InvoiceFileContent>(x => x.Id);
}

查询逻辑 #

• 列表查询：仅加载InvoiceFile，不关联Content，自然不会加载File属性：

var invoices = await _payoutDbContext.Invoices
    .Include(x => x.InvoiceFiles)
    .AsNoTracking()
    .AsSplitQuery()
    .ToListAsync();

• 下载时：单独查询InvoiceFileContent获取文件数据：

var fileContent = await _payoutDbContext.InvoiceFileContents
    .Where(x => x.Id == invoiceFileId)
    .AsNoTracking()
    .FirstOrDefaultAsync();
// 读取fileContent.File即可获取二进制数据

方案三：延迟加载（需注意上下文生命周期） #

如果项目启用了EF Core延迟加载，可以将File属性设为virtual，列表查询时不会自动加载，只有主动访问该属性时才会触发数据库查询：

修改实体定义 #

public class InvoiceFile
{
    public Guid Id { get; set; }
    public string FileName { get; set; }
    // 设为virtual启用延迟加载
    public virtual byte[] File { get; set; }

    public Guid InvoiceId { get; set; }
    public Invoice Invoice { get; set; }
}

启用延迟加载 #

在DbContext配置中启用延迟加载：

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    optionsBuilder
        .UseSqlServer("你的连接字符串")
        .UseLazyLoadingProxies(); // 启用延迟加载代理
}

查询逻辑 #

• 列表查询：IncludeInvoiceFiles时，File属性不会被加载，只有访问invoiceFile.File时才会查询数据库：

var invoices = await _payoutDbContext.Invoices
    .Include(x => x.InvoiceFiles)
    .AsNoTracking()
    .AsSplitQuery()
    .ToListAsync();

注意：使用AsNoTracking时，延迟加载需要上下文未被释放（比如Web请求中，上下文在请求结束后会被Dispose，此时访问File会抛出异常），该方案更适合上下文生命周期较长的场景。

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