ASP.NET Web API中EF插入1:N实体时违反PK_Users唯一约束报错

1. DbContext实体跟踪异常：你查询用户的Get方法大概率是AsNoTracking模式，查出来的用户实体没有被当前上下文跟踪。当你把这个未跟踪的用户赋值给Device的User导航属性时，EF会把该用户识别为新的待插入实体，尝试往Users表插入ID=1的记录，触发主键重复报错。如果传入不存在的UserId，EF也会尝试插入对应ID的空用户，和你描述的现象完全吻合。
2. 实体关系配置错误：你的首次迁移里出现了UserId、UserId1、UserId2三个多余的外键字段，说明EF没有正确识别User和Device的1:N关系，自动生成了冗余外键，这也是导致关联逻辑异常的核心原因之一。

• 第一步：修正实体定义，显式配置外键 #

  修改Device实体，显式添加UserId外键字段，避免EF自动生成冗余字段：

  public class Device
  {
      [Key]
      public int Id { get; set; }
      public string Description { get; set; }
      public string Location { get; set; }
      public double MaxEnergyConsumption { get; set; }
      public double AverageEnergyConsumption { get; set; }
  
      // 显式添加外键
      public int UserId { get; set; }
      // 明确标注外键关联关系
      [ForeignKey(nameof(UserId))]
      public User User { get; set; }
  }
  

• 第二步：清理冗余外键，重新生成迁移 #

  你当前表结构存在3个冗余外键，先删除项目中所有历史迁移文件，再重新执行迁移命令：

  Remove-Migration # 多次执行直到所有迁移都被移除
  Add-Migration InitFixedRelation
  Update-Database
  

  确认新生成的迁移文件中，Devices表仅存在一个UserId外键，无UserId1、UserId2这类自动生成的冗余字段。

• 第三步：优化服务层插入逻辑，避免重复操作 #

  你现有逻辑既把Device加入User的Devices集合、又给Device的User属性赋值、还单独调用Device的Insert方法，属于重复关联操作。推荐直接使用外键赋值的方式插入，无需查询完整用户实体，性能更高也能避免跟踪问题：

  public async Task Insert(DeviceDTOWithoutId entity)
  {
      // 先校验用户是否存在，避免插入非法UserId
      var userExists = await _unitOfWork.Users.AnyAsync(q => q.Id == entity.UserId);
      if (!userExists)
      {
          throw new KeyNotFoundException("指定用户不存在");
      }
      
      var deviceEntity = _mapper.Map<Device>(entity);
      // 直接赋值外键即可，EF会自动维护关联关系
      deviceEntity.UserId = entity.UserId;
  
      await _unitOfWork.Devices.Insert(deviceEntity);
      await _unitOfWork.Save();
  }
  

  如果你一定要使用导航属性关联，确保查询用户的方法不带AsNoTracking，让用户实体被上下文正常跟踪，简化逻辑如下：

  public async Task Insert(DeviceDTOWithoutId entity)
  {
      var userEntity = await _unitOfWork.Users.Get(q => q.Id == entity.UserId);
      if (userEntity == null) throw new KeyNotFoundException("用户不存在");
      
      var deviceEntity = _mapper.Map<Device>(entity);
      // 只需把设备加入用户的设备集合，EF会自动填充外键，不需要单独调用Device的Insert方法
      userEntity.Devices.Add(deviceEntity);
      
      await _unitOfWork.Save();
  }
  

• 第四步：调整仓储Get方法的跟踪配置 #

  确认你仓储的Get方法是否默认加了AsNoTracking，如果是可以增加参数控制跟踪行为，适配不同业务场景：

  public async Task<T> Get(Expression<Func<T, bool>> filter, bool asNoTracking = false)
  {
      var query = _db.Set<T>();
      if (asNoTracking) query = query.AsNoTracking();
      return await query.FirstOrDefaultAsync(filter);
  }
  

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