保存带条件唯一约束的实体时出现循环依赖错误

嘿，你已经搞定了最核心的一环——那个带WHERE [IsPrimary] = 1的唯一索引完全满足需求，数据库层面的约束是确保数据一致性最靠谱的防线，这一步做得很棒！

接下来针对你提到的仓储方法，我给你整理一个健壮的实现版本，既要处理常规业务场景，也要覆盖并发情况下的竞态问题：

核心仓储方法示例 #

假设你需要一个设置指定附件为主附件的方法，比如SetAsPrimaryAsync，可以这么写：

public async Task SetAsPrimaryAsync(Guid recordId, Guid attachmentId, CancellationToken cancellationToken = default)
{
    // 先找到目标附件，确认它属于当前记录
    var targetAttachment = await _dbContext.RecordAttachments
        .FirstOrDefaultAsync(ra => ra.Id == attachmentId && ra.RecordId == recordId, cancellationToken);
    
    if (targetAttachment == null)
        throw new ArgumentException("指定的附件不存在，或者不属于这条记录哦");
    
    // 如果已经是主附件，直接返回就行
    if (targetAttachment.IsPrimary)
        return;

    // 找到当前记录下已有的主附件（如果有）
    var existingPrimary = await _dbContext.RecordAttachments
        .FirstOrDefaultAsync(ra => ra.RecordId == recordId && ra.IsPrimary, cancellationToken);

    // 取消原主附件的标记，设置新的主附件
    if (existingPrimary != null)
        existingPrimary.IsPrimary = false;
    targetAttachment.IsPrimary = true;

    try
    {
        // 提交更改
        await _dbContext.SaveChangesAsync(cancellationToken);
    }
    catch (DbUpdateException ex)
    {
        // 捕获数据库的唯一约束冲突——这是并发场景下的最后防线
        if (ex.InnerException is SqlException sqlEx && (sqlEx.Number == 2601 || sqlEx.Number == 2627))
        {
            throw new InvalidOperationException("哎呀，这条记录已经有主附件啦，请刷新后重试", ex);
        }
        // 其他异常原样抛出
        throw;
    }
}

几个关键细节要注意 #

• 并发安全：就算我们提前做了检查，高并发场景下还是可能出现两个请求同时通过检查的情况，这时候数据库的唯一约束会抛出错误，所以必须捕获DbUpdateException并识别对应的SQL错误码（SQL Server是2601/2627，其他数据库需要对应调整）。
• 原子性操作：修改原主附件和设置新主附件的操作在同一个SaveChanges里完成，确保事务原子性，不会出现“没有主附件”的中间状态。
• 前置检查优化：提前检查附件是否存在、是否已经是主附件，能避免大部分不必要的数据库请求和异常，提升用户体验。

如果是在创建新附件的时候设置IsPrimary，也可以用类似的思路：

public async Task AddAttachmentAsync(RecordAttachment newAttachment, CancellationToken cancellationToken = default)
{
    if (newAttachment.IsPrimary)
    {
        // 先检查当前记录有没有主附件
        var hasPrimary = await _dbContext.RecordAttachments
            .AnyAsync(ra => ra.RecordId == newAttachment.RecordId && ra.IsPrimary, cancellationToken);
        
        if (hasPrimary)
            throw new InvalidOperationException("这条记录已经有主附件了，不能再添加新的主附件哦");
    }

    _dbContext.RecordAttachments.Add(newAttachment);
    
    try
    {
        await _dbContext.SaveChangesAsync(cancellationToken);
    }
    catch (DbUpdateException ex)
    {
        if (ex.InnerException is SqlException sqlEx && (sqlEx.Number == 2601 || sqlEx.Number == 2627))
        {
            throw new InvalidOperationException("创建主附件失败：这条记录已经有主附件啦", ex);
        }
        throw;
    }
}

这样一来，既通过业务逻辑提前拦截了大部分常规问题，又依赖数据库约束作为最后一道保障，完美实现你要的“每个RecordId只能对应一个IsPrimary为true的记录”的需求。

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