Blazor Server中DbContextFactory更新子元素失效的问题及正确实践

问题根源分析 #

你遇到的差异核心在于实体状态追踪：

• 直接注入ApplicationDbContext时，Blazor Server的Scoped生命周期会让上下文长期跟踪当前用户连接中的实体，删除子实体的操作会被上下文自动感知，因此保存时能同步到数据库。但这种方式存在隐患：长期持有上下文可能导致内存膨胀、并发冲突，尤其是在长生命周期组件中。
• 使用DbContextFactory时，每次创建的都是新上下文，传入的Debtor是脱离追踪状态的。Update()方法仅会标记Debtor本身和新增的DebtorContact为变更状态，但已删除的子实体不在新上下文的追踪范围内，EF Core无法识别需要执行删除操作。

正确实现方案 #

Blazor Server官方推荐使用DbContextFactory创建短生命周期上下文，避免Scoped上下文的潜在问题。要实现完整的子实体增删改，需要手动同步实体状态，具体步骤如下：

1. 优化后的DebtorService实现 #

public class DebtorService : IDebtorService
{
    private readonly IDbContextFactory<ApplicationDbContext> _contextFactory;

    public DebtorService(IDbContextFactory<ApplicationDbContext> contextFactory)
    {
        _contextFactory = contextFactory;
    }

    public async Task<bool> UpdateAsync(Debtor debtor)
    {
        try
        {
            using var dbContext = _contextFactory.CreateDbContext();
            // 从数据库加载带关联联系人的Debtor，确保上下文追踪这些实体
            var existingDebtor = await dbContext.Debtors
                .Include(d => d.Contacts)
                .FirstOrDefaultAsync(d => d.Id == debtor.Id);

            if (existingDebtor == null)
                return false;

            // 更新Debtor的基础属性：仅标记实际变更的属性为Modified
            dbContext.Entry(existingDebtor).CurrentValues.SetValues(debtor);

            // 同步联系人集合的增删改
            var existingContacts = existingDebtor.Contacts.ToDictionary(c => c.Id);
            var incomingContacts = debtor.Contacts.ToList();

            // 处理新增/修改联系人
            foreach (var incomingContact in incomingContacts)
            {
                if (existingContacts.TryGetValue(incomingContact.Id, out var existingContact))
                {
                    // 修改现有联系人
                    dbContext.Entry(existingContact).CurrentValues.SetValues(incomingContact);
                    existingContacts.Remove(incomingContact.Id);
                }
                else
                {
                    // 新增联系人，绑定外键
                    incomingContact.DebtorId = debtor.Id;
                    existingDebtor.Contacts.Add(incomingContact);
                }
            }

            // 删除不在传入列表中的联系人
            foreach (var contactToDelete in existingContacts.Values)
            {
                dbContext.DebtorContacts.Remove(contactToDelete);
            }

            await dbContext.SaveChangesAsync();
            return true;
        }
        catch (Exception ex)
        {
            // 此处建议添加日志记录
            return false;
        }
    }
}

2. 关键实现细节 #

• 加载关联实体：通过Include(d => d.Contacts)加载数据库中当前的联系人集合，确保上下文能追踪这些实体的状态变化。
• 按需更新属性：使用CurrentValues.SetValues()仅更新实际变化的属性，避免Update()方法强制标记整个实体为Modified的性能浪费。
• 手动同步集合：对比传入的联系人列表与数据库中的列表，分别处理新增、修改、删除操作，确保所有变更都被上下文感知。

Blazor Server最佳实践 #

• 优先使用DbContextFactory：创建短期上下文（通过using块自动释放），避免Scoped上下文长期持有导致的内存泄漏、并发问题。
• 避免直接使用Update()：该方法会强制标记整个实体及关联实体为变更状态，不仅性能差，还无法识别已删除的子实体。
• 手动处理集合变更：EF Core默认不会自动处理脱离追踪实体的集合删除操作，必须通过对比现有数据与传入数据来实现。

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