添加含外键关联子对象的实体时EF Core跟踪异常问题

场景说明 #

基于Blazor Server + Entity Framework Core开发，涉及三张表：Student、TestDetail、SubjectType，关联规则：

• 单名学生对应多条TestDetail记录
• 每条TestDetail通过SubjectTypeId关联SubjectType表

实体类及配置代码 #

public class Student
{
    public int Id { get; set;}
    public virtual ICollection<TestDetail> TestDetails{ get; set; } = new List<TestDetail>();
}

public class TestDetail
{
     public int StudentId { get; set; }
     public virtual Student Student { get; set; } = null!;
     public int? SubjectTypeId { get; set; }
     public virtual SubjectType? SubjectType { get; set; } = null!;
}

public class TestDetailConfiguration
{
      entity.Property(e => e.SubjectTypeId).HasColumnName("SUBJECT_TYPE_CD");
      entity.HasOne(d => d.SubjectType).WithMany()
              .HasForeignKey(d => d.TestSubjectTypeId) // 注：此处疑似笔误，应为SubjectTypeId
              .HasConstraintName("FK_NAME_TO_SUBJECT_TABLE");
       entity.HasOne(d => d.Student).WithMany(p => p.TestDetails)
            .HasForeignKey(d => d.StudentId)
            .OnDelete(DeleteBehavior.ClientCascade)
            .HasConstraintName("FK_T_...");
}

UI数据获取与页面逻辑 #

科目列表获取服务 #

public List<SubjectType> GetSubjects()
{
    using (var _context = factory.CreateDbContext())
    {
        var rows = _context.Set<Subject>(); // 注：此处疑似笔误，应为SubjectType
        return rows;
    }
}

Blazor页面初始化代码 #

[Inject]
private IDbContextFactory<DBContext> factory { get; set; }
private DBContext _dbContext;
private IEnumerable<SubjectType> subjectTypes = [];

private void OnInitialized() // 注：原代码拼写错误Onintialized
{
    _dbContext = factory.CreateDbContext();
    subjectTypes = Service.GetSubjects();
    Student student = new Student();
    _dbContext.Students.Add(student);
}

添加测试记录逻辑 #

点击按钮创建TestDetail并关联选中科目：

student.TestDetails.Add(new TestDetail());
// 后续为TestDetail的SubjectType属性赋值下拉框选中的科目实例

报错信息 #

添加两条关联同一科目（如ID=1的英语）的测试记录时，保存抛出异常：

The instance of entity type cannot be tracked because another instance of this type with the same key {1} is already being tracked.

已尝试在获取科目列表时使用.AsNoTracking()，问题未解决。

解决方案 #

核心原因 #

1. 服务类GetSubjects创建的DbContext与页面中_dbContext是两个独立实例
2. 服务中获取的SubjectType实例来自第一个上下文，赋值给页面上下文跟踪的TestDetail时，页面上下文会尝试跟踪该实例；若已有另一条TestDetail关联同一SubjectType，则会因同一主键实体被多上下文获取、当前上下文重复跟踪而触发异常。

具体解决方法 #

方法1：直接设置外键值而非关联实体实例

无需绑定SubjectType实体，直接赋值外键字段即可：

// 假设下拉框绑定选中科目的Id为selectedSubjectId
var newTestDetail = new TestDetail { SubjectTypeId = selectedSubjectId };
student.TestDetails.Add(newTestDetail);

此方式最简洁，EF Core会自动处理外键关联，无需跟踪SubjectType实体。

方法2：统一使用同一个DbContext获取科目列表

修改服务方法支持传入上下文实例，避免创建新上下文：

// 调整服务方法
public List<SubjectType> GetSubjects(DBContext context)
{
    return context.Set<SubjectType>().ToList();
}

// 页面调用时传入当前上下文
private void OnInitialized()
{
    _dbContext = factory.CreateDbContext();
    subjectTypes = Service.GetSubjects(_dbContext);
    Student student = new Student();
    _dbContext.Students.Add(student);
}

所有SubjectType实例由页面上下文统一跟踪，重复赋值同一实例不会触发跟踪冲突。

方法3：将服务获取的实体附加到当前上下文

若必须使用不同上下文，可在赋值前将SubjectType附加到页面上下文：

var selectedSubject = // 下拉框选中的科目实例
if (_dbContext.Entry(selectedSubject).State == EntityState.Detached)
{
    _dbContext.Attach(selectedSubject);
}
// 赋值给TestDetail
var newTestDetail = new TestDetail { SubjectType = selectedSubject };
student.TestDetails.Add(newTestDetail);

若无需更新SubjectType，也可标记为无跟踪状态：

var selectedSubject = // 下拉框选中的科目实例
_dbContext.Entry(selectedSubject).State = EntityState.Unchanged;
var newTestDetail = new TestDetail { SubjectType = selectedSubject };
student.TestDetails.Add(newTestDetail);

补充：修正代码笔误 #

• TestDetailConfiguration中外键配置的d.TestSubjectTypeId需改为d.SubjectTypeId，与实体类属性一致
• GetSubjects方法中_context.Set<Subject>()需改为_context.Set<SubjectType>()
• 页面初始化方法Onintialized拼写错误，应为OnInitialized

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