EF Core 8添加用户角色时出现实体跟踪冲突问题求助

在项目中，我尝试将指定的User设置为某Club的Trainer。为此，我创建了与User一对一关联的Trainer实体，Club则包含User和Trainers集合。

添加Trainer到Club时一切正常，数据能正确写入数据库，但一旦为User添加特定角色，就会抛出错误：

System.InvalidOperationException: The instance of entity type 'User' cannot be tracked because another instance with the same key value for {'Id'} is already being tracked

奇怪的是，第一次发送请求时正常，第二次就报错；重启调试后再次执行端点能正常运行，但升级另一个用户时又会报错。

实体导航属性 #

Club导航属性 #

public IReadOnlyCollection<Trainer> Trainers => _trainers;
public IReadOnlyCollection<User> Members => _members;

User导航属性 #

public IReadOnlyCollection<Trainer> Trainers => _trainers;

Trainer导航属性 #

public UserId UserId { get; private set; }
public User? User { get; private set; } 
public ICollection<Club> Clubs => _clubs;

核心代码 #

创建Trainer并添加用户角色的处理程序 #

public async Task<Result> Handle(AddTrainerToClubCommand command,
    CancellationToken cancellationToken)
{
    var club = await _clubRepository.FindByIdAsync(command.ClubId, 
        x => x.Include(club => club.Trainers).ThenInclude(t => t.User), cancellationToken: cancellationToken);
    
    if (club is null)
    {
        return Result.NotFound(typeof(Club));
    }
    
    // 检查用户是否已成为该俱乐部的Trainer
    if (club.Trainers.Any(trainer => trainer.UserId.Equals(UserId.Create(command.AddTrainerToClubRequest.UserId))))
    {
        return Result.Failure(ClubErrors.TrainerAlreadyInClub);
    }
    
    var user = await _userRepository.FindByIdAsync(UserId.Create(command.AddTrainerToClubRequest.UserId), cancellationToken: cancellationToken);
    
    if (user is null)
    {
        return Result.NotFound(typeof(User));
    }
    
    var trainer = new Trainer(TrainerId.Create(Guid.NewGuid()), user);
    club.AddTrainer(trainer);
    
    await _trainerRepository.AddAsync(trainer, cancellationToken);
    await _unitOfWork.SaveChangesAsync(cancellationToken);

    return Result.Success();
}

Trainer构造函数内部 #

public Trainer(TrainerId id,
    User user)
    : base(id)
{
    UserId = user.Id;
    User = user;
    User.AddRole(Role.ClubTrainer); // <-- 添加此行后出现错误
}

补充信息 #

使用EF Core 8.0.0，Role是自定义枚举实体：

public class Role : Enumeration<Role>
{
    public static readonly Role RegisteredUser = new Role(1, "RegisteredUser");
    public static readonly Role DummyRole = new Role(2, "DummyRole");
    public static readonly Role ClubAdmin = new Role(3, "ClubAdmin");
    public static readonly Role ClubOwner = new Role(4, "ClubOwner");
    public static readonly Role ClubTrainer = new Role(5, "ClubTrainer");
    
    public Role(
        int id,
        string name)
        : base(id, name)
    {
    }

    public ICollection<Permission> Permissions { get; set; } = new List<Permission>();
    public ICollection<User> Users { get; set; } = new List<User>();
}

AddRole仅为User实体的Roles集合执行Roles.add(role)操作。

问题根源 #

错误源于EF Core的实体跟踪冲突：

1. 加载Club时通过Include(club => club.Trainers).ThenInclude(t => t.User)已经跟踪了目标User实例
2. 后续通过_userRepository.FindByIdAsync再次查询同一个User，若仓储实现未正确处理跟踪（如返回新实例），会导致EF同时尝试跟踪两个相同Id的User
3. 构造函数中修改User的Roles时，触发EF的跟踪检查，引发冲突

第一次请求正常是因为DbContext是新实例，无残留跟踪；第二次请求复用DbContext，之前的跟踪实例未释放，因此报错。

修复方法 #

方法1：避免重复查询User #

直接从已加载的Club关联中获取User，或确保查询时关闭跟踪：

// 从Club的关联中获取User，不存在再查询
var user = club.Trainers.Select(t => t.User)
           .FirstOrDefault(u => u.Id.Equals(UserId.Create(command.AddTrainerToClubRequest.UserId))) 
           ?? await _userRepository.FindByIdAsync(UserId.Create(command.AddTrainerToClubRequest.UserId), cancellationToken: cancellationToken);

或在查询User时关闭跟踪（需仓储支持）：

var user = await _userRepository.FindByIdAsync(
    UserId.Create(command.AddTrainerToClubRequest.UserId), 
    tracking: false, // 关闭跟踪
    cancellationToken: cancellationToken);

方法2：迁移添加角色的逻辑 #

将添加角色的操作移出Trainer构造函数，放到处理程序中，确保操作的是同一个被跟踪的User实例：

// 修改Trainer构造函数，移除添加角色的代码
public Trainer(TrainerId id, User user) : base(id)
{
    UserId = user.Id;
    User = user;
}

// 在处理程序中添加角色
var trainer = new Trainer(TrainerId.Create(Guid.NewGuid()), user);
club.AddTrainer(trainer);
user.AddRole(Role.ClubTrainer); // 移到此处执行

await _trainerRepository.AddAsync(trainer, cancellationToken);
await _unitOfWork.SaveChangesAsync(cancellationToken);

方法3：确认DbContext生命周期配置 #

确保DbContext为请求作用域（ASP.NET Core默认配置），每个请求创建新的DbContext实例，避免残留跟踪实例导致冲突。

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