添加AuthorizationCode时EntityFramework重复创建Grant引发主键冲突

问题核心 #

添加AuthorizationCode时，EF Core 尝试插入已存在的Grant实体，触发主键重复异常，本质是EF的实体跟踪机制和关联关系配置缺失导致的问题。

原因分析 #

1. 关联关系未明确配置
   你的AuthorizationCodeConfiguration仅定义了自身主键，没有配置与Grant的外键关联逻辑。EF Core无法识别AuthorizationCode.Grant是对已有实体的引用，会默认将其当作新实体处理，执行插入操作。

2. 实体未被当前上下文跟踪
   Grant是在其他HTTP端点创建的，当前操作的DbContext实例并没有跟踪这个Grant对象。当你把这个未被跟踪的Grant赋值给AuthorizationCode时，EF Core无法判断它是否已存在于数据库，只能按新实体处理。

解决方法 #

1. 补全关联关系配置 #

修改AuthorizationCodeConfiguration，明确外键关联：

public class AuthorizationCodeConfiguration : IEntityTypeConfiguration<AuthorizationCode>
{
    public void Configure(EntityTypeBuilder<AuthorizationCode> builder)
    {
        builder.HasKey(p => p.Code);
        // 配置与Grant的关联（假设Grant无反向导航属性）
        builder.HasOne(a => a.Grant)
               .WithMany()
               .HasForeignKey("GrantId") // 建议在AuthorizationCode实体中显式添加该外键字段
               .OnDelete(DeleteBehavior.Restrict); // 根据业务需求设置删除行为
    }
}

同时在AuthorizationCode实体中添加显式外键字段，让关联关系更清晰：

public class AuthorizationCode
{
    public string Code { get; set; }
    public string? GrantId { get; set; } // 显式外键字段
    public Grant? Grant { get; set; }
    // 其他属性省略
}

2. 确保Grant被上下文识别为已存在 #

有两种常用实现方式：

• 方式一：查询获取已跟踪的Grant
  在当前上下文查询出已存在的Grant，再赋值给AuthorizationCode，此时EF会自动识别为已跟踪的实体：

  var existingGrant = await _dbContext.Grants.FirstOrDefaultAsync(g => g.GrantId == authorizationCode.Grant.GrantId, cancellationToken);
  if (existingGrant != null)
  {
      authorizationCode.Grant = existingGrant;
  }
  await _dbContext.AddAsync(authorizationCode, cancellationToken);
  await _dbContext.SaveChangesAsync(cancellationToken);
  

• 方式二：手动标记实体状态
  直接将关联的Grant标记为Unchanged，告诉EF该实体已存在于数据库，无需插入：

  _dbContext.Entry(authorizationCode.Grant).State = EntityState.Unchanged;
  await _dbContext.AddAsync(authorizationCode, cancellationToken);
  await _dbContext.SaveChangesAsync(cancellationToken);
  

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