.NET9 Blazor Minimal API中EF Core关联对象更新失败排查

我有一个基于.NET9和Blazor的应用，对外暴露Minimal API。简化模型中，Client包含与School的一对一关联、与Channels的多对多关联属性。通过脚手架生成的Client PUT接口未处理关联对象，自行修改代码后，出现两个问题：

1. Client的SchoolId仍为空
2. 关联的Channel仅第一个被添加
   请问哪里操作错误？

模型代码 #

public class Client {
   public School? School { get; set; }
   public IList<Channel>? Channels { get; set; }
}

public class Channel
{
    [Key]
    [DatabaseGenerated(DatabaseGeneratedOption.Identity)]
    public long ID { get; set; }

    public string Name { get; set; } = string.Empty;
}

public class School
{
    [Key]
    [DatabaseGenerated(DatabaseGeneratedOption.Identity)]
    public long ID { get; set; }

    public string Name { get; set; } = string.Empty;
}

脚手架生成的PUT接口代码 #

group.MapPut("/{id}", async Task<Results<Ok, NotFound>> (long id, 
                      Domain.Client client, DbContext db) => {
    var affected = await db.Client
        .Where(model => model.ID == id)
        .ExecuteUpdateAsync(setters => setters
            .SetProperty(m => m.FirstName, client.FirstName)
            // 更多字段，但未包含School或Channel
            );
    return affected == 1 ? TypedResults.Ok() : TypedResults.NotFound();
}

修改后的PUT接口代码 #

group.MapPut("/{id}", async Task<Results<Ok, NotFound>> (long id, 
                      Domain.Client client, DbContext db) => {
    if(client.Channels != null)
    {
        var listChannels = client.Channels.ToList();
        client.Channels = new List<Channel>();
        foreach(Channel c in listChannels)
        {
            var cn = db.Channels.Where(t => t.ID == c.ID).FirstOrDefault();
            if (cn != null)
                client.Channels.Add(cn);
        }
    }

    if (client.School != null)
    {
        var school = db.Schools
            .Where(s => s.ID == client.School.ID).FirstOrDefault();
        if (school != null)
            client.School = school;
        else
            client.School = null;
    }

    var affected = await db.Client
        .Where(model => model.ID == id)
        .ExecuteUpdateAsync(setters => setters
            .SetProperty(m => m.FirstName, client.FirstName)
            );
    return affected == 1 ? TypedResults.Ok() : TypedResults.NotFound();
}

问题分析与解决 #

核心错误：ExecuteUpdateAsync不处理导航属性 #

你当前使用的ExecuteUpdateAsync是EF Core的批量更新方法，仅能更新实体的基础标量属性，完全不会处理School、Channels这类导航属性（关联对象）。你对传入client对象的导航属性修改根本没有被EF Core追踪，也不会同步到数据库。

针对两个问题的具体原因与修复： #

1. SchoolId为空的问题

• 原因：你修改了传入的client.School，但没有将这个修改绑定到数据库中已存在的Client实体上，EF Core无法感知到关联关系的变化。
• 修复：先查询数据库中目标Client实体（包含关联的School），直接修改该实体的School属性，再保存更改。

2. Channel仅第一个被添加的问题

• 原因：同样是ExecuteUpdateAsync不处理多对多关联，且你修改的是未被追踪的传入client对象的Channels集合，而非数据库中目标Client的关联集合。
• 修复：查询目标Client时包含关联的Channels，清空原有集合后添加有效Channel实体，再保存更改。

修正后的PUT接口代码 #

group.MapPut("/{id}", async Task<Results<Ok, NotFound>> (long id, 
                      Domain.Client clientInput, DbContext db) => {
    // 从数据库查询要更新的Client，包含关联的School和Channels
    var targetClient = await db.Client
        .Include(c => c.School)
        .Include(c => c.Channels)
        .FirstOrDefaultAsync(c => c.ID == id);

    if (targetClient == null)
    {
        return TypedResults.NotFound();
    }

    // 更新基本属性
    targetClient.FirstName = clientInput.FirstName;
    // 其他基本属性...

    // 处理School关联
    if (clientInput.School != null)
    {
        var school = await db.Schools.FindAsync(clientInput.School.ID);
        targetClient.School = school;
    }
    else
    {
        targetClient.School = null;
    }

    // 处理Channels多对多关联
    if (clientInput.Channels != null && clientInput.Channels.Any())
    {
        targetClient.Channels.Clear();
        // 批量查询需要关联的Channel
        var channelIds = clientInput.Channels.Select(c => c.ID).ToList();
        var channelsToAdd = await db.Channels.Where(c => channelIds.Contains(c.ID)).ToListAsync();
        foreach (var channel in channelsToAdd)
        {
            targetClient.Channels.Add(channel);
        }
    }
    else
    {
        targetClient.Channels.Clear();
    }

    // 保存所有更改
    await db.SaveChangesAsync();
    return TypedResults.Ok();
}

额外注意事项 #

• 必须操作数据库中查询出的被EF Core追踪的实体，而非传入的未追踪对象，否则修改不会同步到数据库。
• EF Core会自动维护多对多的中间表，只要修改被追踪实体的导航属性集合，调用SaveChangesAsync时就会同步更新中间表。
• 批量查询Channel比循环单个查询效率更高，避免多次数据库请求。

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