EF尝试插入Unchanged实体时触发DbUpdateException问题求助

大家好！之前我在使用Entity Framework调用SaveChanges()的时候踩了个坑，抛出了DbUpdateException，错误提示是：

保存未公开关系外键属性的实体时发生错误。由于无法确定单个实体作为异常源，EntityEntries属性将返回null。保存操作时的异常处理可能……

折腾了一番终于解决了，感谢之前帮过我的朋友们！这个问题主要是我自己代码设计的问题，现在把解决方案整理出来，说不定能帮到遇到同样问题的小伙伴。

问题根源 #

本质上是我没有显式配置实体间的外键关系，而且在保存关联实体时，没有正确处理实体的跟踪状态，导致EF无法识别关联关系，找不到异常源，所以EntityEntries才会返回null。

具体修复步骤 #

1. 给实体类显式添加外键属性
   之前我只在实体里加了导航属性，没加对应的外键字段，EF虽然能隐式生成，但很容易出问题。比如我有Order和Customer两个实体，现在给Order加上CustomerId：

   public class Order
   {
       public int Id { get; set; }
       // 显式添加外键，和导航属性对应
       public int CustomerId { get; set; }
       public Customer Customer { get; set; }
   }
   

   然后在DbContext的OnModelCreating里明确配置关联关系，避免EF的隐式推断出错：

   protected override void OnModelCreating(ModelBuilder modelBuilder)
   {
       modelBuilder.Entity<Order>()
           .HasOne(o => o.Customer) // Order属于一个Customer
           .WithMany(c => c.Orders) // Customer有多个Order
           .HasForeignKey(o => o.CustomerId); // 外键是CustomerId
   }
   

2. 保存时正确处理关联实体的状态
   之前我直接给Order的Customer导航属性赋值了一个新的Customer对象，但没把这个新Customer添加到上下文，EF不知道怎么处理这个未跟踪的关联实体，就报错了。现在改成两种正确的做法：

   • 如果是新创建的关联实体：先把关联实体添加到上下文，再设置外键

     var newCustomer = new Customer { Name = "张三" };
     _context.Customers.Add(newCustomer); // 先添加到上下文，让EF跟踪
     var newOrder = new Order { CustomerId = newCustomer.Id }; // 用外键关联
     _context.Orders.Add(newOrder);
     await _context.SaveChangesAsync();
     

   • 如果关联实体已经存在：直接用已存在实体的ID设置外键，不要直接赋值导航属性

     var existingCustomer = await _context.Customers.FindAsync(1);
     var newOrder = new Order { CustomerId = existingCustomer.Id };
     _context.Orders.Add(newOrder);
     await _context.SaveChangesAsync();
     

3. 调试小技巧
   要是再遇到EntityEntries为null的情况，可以在保存前查看上下文的ChangeTracker，看看所有待变更的实体状态，就能定位到哪个实体的关系有问题了：

   // 输出所有待添加/修改的实体信息
   var pendingEntities = _context.ChangeTracker.Entries()
       .Where(e => e.State is EntityState.Added or EntityState.Modified);
   foreach (var entry in pendingEntities)
   {
       Console.WriteLine($"实体类型：{entry.Entity.GetType().Name}，状态：{entry.State}");
   }
   

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