EF Core保存关联Identity外键的Client模型时触发SQL异常

问题原因 #

你在保存Client时触发的SQL异常，本质是跨DbContext实体跟踪导致的误插入：
通过_userManager.FindByIdAsync获取的AgentUser实例，属于UserManager专属的DbContext，而非当前操作Client的DbContext。当你将该实例赋值给newClient.Referrer时，当前DbContext会将其判定为新实体，尝试执行INSERT操作。而该AgentUser自身的自引用外键ReferrerId可能指向不存在的用户，或外键约束检查不通过，最终触发冲突。

解决方案 #

方案一：直接设置外键值（推荐，性能更优） #

无需加载AgentUser实例，直接给Client的ReferrerId赋值即可，彻底避免跨上下文跟踪问题：

if (Input.ReferrerId != null)
{
    // 可选：验证ReferrerId是否存在
    var referrerExists = await _context.AgentUsers.AnyAsync(u => u.Id == Input.ReferrerId);
    if (!referrerExists)
    {
        ModelState.AddModelError(string.Empty, $"不存在ID为{Input.ReferrerId}的代理用户");
        return Page();
    }
    // 直接设置外键，不依赖导航属性
    newClient.ReferrerId = Input.ReferrerId;
}

方案二：将AgentUser附加到当前DbContext #

如果必须使用导航属性，可将从UserManager获取的实例附加到当前DbContext，标记为已存在状态，阻止EF误插入：

if (Input.ReferrerId != null)
{
    AgentUser referrer = await _userManager.FindByIdAsync(Input.ReferrerId);
    if (referrer == null)
    {
        ModelState.AddModelError(string.Empty, $"不存在ID为{Input.ReferrerId}的代理用户");
        return Page();
    }
    // 将实例附加到当前上下文，标记为未修改状态
    _context.Attach(referrer).State = EntityState.Unchanged;
    newClient.Referrer = referrer;
}

可选：完善AgentUser自引用配置 #

确保DbContext中正确配置自引用外键，避免潜在的约束问题：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder);

    modelBuilder.Entity<AgentUser>()
        .HasOne(u => u.Referrer)
        .WithMany(u => u.Referrals)
        .HasForeignKey(u => u.ReferrerId)
        .OnDelete(DeleteBehavior.Restrict); // 防止级联删除引发的连锁问题
}

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