EntityFramework Core 9.0 中主键生成策略的变更与正确使用指南

在 EntityFramework Core 9.0 版本中，开发团队对实体主键生成策略的处理逻辑进行了优化调整，这导致了一些在 EF Core 8.0 及之前版本可以正常工作的代码在升级后出现了异常行为。本文将深入分析这一变更的技术背景，解释正确的使用方式，并提供多种解决方案。

问题现象

当开发者在 EF Core 9.0 中使用以下模式时可能会遇到问题：

var parent = db.Parents.Include(p => p.Child).First();
parent.Child = new Child {
    Id = Guid.NewGuid(), // 手动设置主键值
    // 其他属性...
};
db.SaveChanges();

在 EF Core 8.0 中，这段代码可以正常工作并生成 INSERT 语句。但在 EF Core 9.0 中，框架会错误地生成 UPDATE 语句，导致数据库操作失败并抛出乐观并发异常。

技术背景分析

EF Core 对于实体主键的处理逻辑在 9.0 版本中变得更加严格和准确。默认情况下，Guid 类型的主键被配置为自动生成值。这意味着：

1. 当 EF Core 检测到一个实体对象的主键已经被显式设置时，它会认为这是一个已存在于数据库中的实体
2. 因此会尝试生成 UPDATE 语句而不是 INSERT 语句
3. 当数据库中实际上不存在该记录时，就会导致更新操作影响0行，触发乐观并发异常

解决方案

方案一：遵循自动生成主键的最佳实践

最简单的解决方案是遵循 EF Core 的设计意图，不手动设置主键值：

var parent = db.Parents.Include(p => p.Child).First();
parent.Child = new Child {
    // 不设置 Id，让 EF Core 自动生成
    // 其他属性...
};
db.SaveChanges();

这种方式最符合 EF Core 的设计哲学，也是推荐的做法。

方案二：显式配置主键不自动生成

如果业务需求确实需要手动设置主键值，可以在 DbContext 的 OnModelCreating 方法中明确配置：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Child>(entity => {
        entity.Property(e => e.Id).ValueGeneratedNever();
    });
}

这样配置后，EF Core 就不会假设手动设置的主键值代表已存在的实体。

方案三：显式设置实体状态

另一种灵活的方式是直接控制实体的状态：

var child = new Child {
    Id = Guid.NewGuid(), // 手动设置主键
    // 其他属性...
};

db.Entry(child).State = EntityState.Added; // 明确指示这是新增实体
parent.Child = child;
db.SaveChanges();

或者使用更简洁的 Add 方法：

var child = new Child {
    Id = Guid.NewGuid(),
    // 其他属性...
};

db.Add(child); // 这会自动设置状态为 Added
parent.Child = child;
db.SaveChanges();

版本兼容性建议

对于从 EF Core 8.0 升级到 9.0 的项目，建议：

1. 审查所有实体创建代码，特别是那些手动设置主键值的情况
2. 根据业务需求选择上述合适的解决方案
3. 考虑编写单元测试来验证实体创建行为是否符合预期

总结

EF Core 9.0 对主键生成策略的处理更加严格和准确，这虽然可能导致一些现有代码需要调整，但从长远来看提高了框架行为的可预测性。开发者应当理解这一变更的技术背景，并根据自己的业务场景选择合适的处理方式。无论是采用自动生成主键、显式配置还是手动控制实体状态，都能确保数据操作的准确性和可靠性。