Entity Framework Core中外键异常缓存：错误数据重复提交问题

问题根源 #

EF Core 的 DbContext 是有状态的：当你第一次将错误的 Doc 实体（DocTypeId=0）通过 AddAsync 添加到上下文后，该实体就会被上下文跟踪。即便后续传入正确的实体，调用 SaveChangesAsync 时，上下文会把所有处于跟踪状态的实体（包括之前错误的那个）一并提交到数据库，导致重复触发外键约束异常。

解决方案 #

1. 确保 DbContext 使用 Scoped 生命周期（ASP.NET Core 环境） #

在 ASP.NET Core 中，默认 DbContext 的生命周期是 Scoped（每个请求创建一个新的上下文实例）。如果项目中自定义了生命周期（比如 Singleton），会导致多个请求共用同一个上下文，残留之前的跟踪实体。
检查 Program.cs 中的配置：

builder.Services.AddDbContext<YourDbContext>(options => 
    options.UseSqlServer("你的连接字符串"));
// 上述代码默认就是 Scoped，无需额外配置

2. 捕获异常后移除错误实体的跟踪 #

如果必须复用上下文，在捕获异常后，将错误实体从上下文的跟踪列表中移除，避免后续提交时被包含：

public async Task AddAsync(Doc d)
{
    try
    {
        await _dbContext.Doc.AddAsync(d);
        await _dbContext.SaveChangesAsync();
    }
    catch (Exception exp)
    {
        // 移除当前错误实体的跟踪状态
        _dbContext.Entry(d).State = EntityState.Detached;
        throw;
    }
}

3. 提前验证外键合法性 #

在添加实体前，先验证 DocTypeId 对应的 DocType 是否存在，从源头避免外键异常：

public async Task AddAsync(Doc d)
{
    // 先检查对应的 DocType 是否存在
    var docTypeExists = await _dbContext.DocType.AnyAsync(dt => dt.Id == d.DocTypeId);
    if (!docTypeExists)
    {
        throw new ArgumentException($"不存在 Id 为 {d.DocTypeId} 的 DocType");
    }

    try
    {
        await _dbContext.Doc.AddAsync(d);
        await _dbContext.SaveChangesAsync();
    }
    catch (Exception exp)
    {
        throw;
    }
}

4. 谨慎使用全局清空跟踪（仅特殊场景） #

如果需要一次性清空所有跟踪实体，可以使用以下方法，但会影响上下文内其他正在处理的实体，需谨慎：

// 清空上下文所有跟踪的实体
_dbContext.ChangeTracker.Clear();

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