EF Core 中 SetValues 方法在更新父子关系时的异常问题分析

问题背景

在 EF Core 8.0.13 版本中，开发人员在使用 SetValues 方法更新包含子对象的实体时遇到了外键约束异常。这个问题在 EF Core 7 版本开始出现，但在 EF Core 6 及以下版本中工作正常。

问题重现

考虑以下两个实体类：

public class Parent
{
    public int Id { get; set; }
    public string Name { get; set; } = "";
    public List<Child> Children { get; set; } = [];
}

public class Child
{
    public int Id { get; set; }
    public string Name { get; set; } = "";
    public int ParentId { get; set; }
}

当使用 SetValues 方法更新父对象并添加子对象时：

var newParent = new Parent();
_databaseContext.Add(newParent);
_databaseContext.Entry(newParent).CurrentValues.SetValues(parentDto);

foreach (var child in parentDto.Children)
{
    var newChild = new Child();
    newParent.Children.Add(newChild);
    _databaseContext.Entry(newChild).CurrentValues.SetValues(child);
}
_databaseContext.SaveChanges();

异常原因分析

在 EF Core 7 和 8 版本中，当使用 SetValues 方法时，EF Core 会错误地将父对象和子对象的插入操作合并在一起执行，导致在插入子对象时父对象的主键尚未生成，从而引发外键约束异常。

生成的 SQL 对比

使用 SetValues 方法时生成的 SQL:

SET NOCOUNT ON;
INSERT INTO [Parent] ([Name])
OUTPUT INSERTED.[Id]
VALUES (@p0);
INSERT INTO [Child] ([Name], [ParentId])
OUTPUT INSERTED.[Id]
VALUES (@p1, @p2);

手动赋值时生成的 SQL:

SET IMPLICIT_TRANSACTIONS OFF;
SET NOCOUNT ON;
INSERT INTO [Parent] ([Name])
OUTPUT INSERTED.[Id]
VALUES (@p0);

SET IMPLICIT_TRANSACTIONS OFF;
SET NOCOUNT ON;
INSERT INTO [Child] ([Name], [ParentId])
OUTPUT INSERTED.[Id]
VALUES (@p1, @p2);

解决方案

临时解决方案

1. 手动赋值替代 SetValues:

var newParent = new Parent();
_databaseContext.Add(newParent);

newParent.Id = parentDto.Id;
newParent.Name = parentDto.Name;

foreach (var child in parentDto.Children)
{
    var newChild = new Child();
    newParent.Children.Add(newChild);
    newChild.Id = child.Id;
    newChild.Name = child.Name;
}
_databaseContext.SaveChanges();

2. 升级到 EF Core 9: 这个问题在 EF Core 9 中已经修复。

技术原理深入

SetValues 方法在 EF Core 中用于将一个对象的属性值复制到另一个对象。在 EF Core 7 和 8 中，当处理包含导航属性的实体时，该方法的行为发生了变化，导致状态管理器在处理父子关系时出现了顺序问题。

在正确的实现中，EF Core 应该：

1. 先插入父对象并获取生成的主键
2. 然后使用该主键值设置子对象的外键
3. 最后插入子对象

但在有问题的版本中，EF Core 试图一次性处理所有插入操作，没有正确等待父对象的主键生成。

最佳实践建议

1. 对于复杂的实体关系更新，考虑分步操作：

   • 先处理父实体
   • 保存更改获取ID
   • 再处理子实体

2. 在升级 EF Core 版本时，特别注意状态管理和关系处理方面的测试

3. 对于关键业务逻辑，考虑使用显式的事务控制来确保操作顺序

这个问题虽然特定于 SetValues 方法在父子关系场景下的使用，但它提醒我们在使用 ORM 工具的高级功能时需要理解其内部工作机制，特别是在处理实体关系时。