EF Core 7+中string.Join未转译为STRING_AGG的问题排查

你遇到的问题是EF Core 7+未将string.Join翻译为SQL Server的STRING_AGG，反而在客户端拉取所有关联数据后拼接，根源在于写法或配置未触发EF Core的翻译规则，以下是具体原因和解决办法：

可能的原因 #

1. 写法不符合翻译规则：EF Core对string.Join的翻译有严格要求，第二个参数必须是数据库端可处理的IQueryable集合，如果导航属性被隐式转为内存集合（比如之前调用过ToList()等方法），EF Core会直接在客户端执行拼接。
2. 导航属性配置错误：如果Account和Customer的一对多关系未正确配置，EF Core无法识别l.Customers是数据库关联集合，也就无法生成聚合SQL。
3. EF Core版本不足：确认你的项目确实使用了EF Core 7.0或更高版本，低于该版本不支持string.Join到STRING_AGG的翻译。

解决办法 #

1. 确认EF Core版本 #

查看项目NuGet包中Microsoft.EntityFrameworkCore.SqlServer的版本，确保≥7.0。

2. 检查导航属性配置 #

确保实体类和DbContext中的关系配置正确：

// Account实体
public class Account
{
    public int AccountId { get; set; }
    public ICollection<Customer> Customers { get; set; } = new List<Customer>();
}

// Customer实体
public class Customer
{
    public int CustomerID { get; set; }
    public string FirstName { get; set; }
    public int AccountId { get; set; }
    public Account Account { get; set; }
}

// DbContext配置
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Customer>()
        .HasOne(c => c.Account)
        .WithMany(a => a.Customers)
        .HasForeignKey(c => c.AccountId);
}

3. 调整查询写法触发翻译 #

如果string.Join仍不生效，可以尝试两种更明确的写法：

写法一：使用EF.Functions.StringAgg（推荐）

直接调用EF Core提供的数据库函数，确保在数据库端执行聚合：

var names = await _context.Account
    .Select(l => new
    {
        Names = EF.Functions.StringAgg(l.Customers.Select(x => x.FirstName), " | ")
    })
    .ToListAsync();

写法二：显式子查询

通过子查询明确指定聚合逻辑，强制EF Core生成STRING_AGG：

var names = await _context.Account
    .Select(a => new
    {
        Names = _context.Customer
            .Where(c => c.AccountId == a.AccountId)
            .Select(c => c.FirstName)
            .Aggregate((prev, curr) => $"{prev} | {curr}")
    })
    .ToListAsync();

4. 禁用客户端评估排查问题 #

在DbContext中配置禁用客户端评估，这样EF Core无法翻译查询时会直接抛出异常，帮助定位问题：

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    optionsBuilder
        .UseSqlServer("你的连接字符串")
        .ConfigureWarnings(warnings => warnings.Throw(RelationalEventId.QueryClientEvaluationWarning));
}

正确生成的SQL示例 #

调整后EF Core应该生成类似以下的SQL，和你的期望一致：

SELECT 
    (SELECT STRING_AGG([c].[FirstName], N' | ') 
     FROM [Customer] AS [c] 
     WHERE [c].[AccountId] = [l].[AccountId]) AS [Names]
FROM [Accounts] AS [l]

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