EntityFramework Core 中关于非确定性种子数据的注意事项

在 EntityFramework Core 9.0 版本中，开发团队引入了一个重要的变更，使得模型变更检测更加严格。这一变更特别影响了使用 HasData() 方法进行数据种子设定的场景，尤其是当种子数据中包含非确定性值（如 DateTime.Now）时。

问题背景

许多开发者习惯在数据种子设定中使用动态生成的值，例如：

modelBuilder.Entity<DiaryEntry>().HasData(
    new DiaryEntry
    {
        Id = 1,
        Title = "Went Hiking",
        Content = "Went hiking with Joe!",
        Created = DateTime.Now
    }
);

这种写法在 EF Core 9.0 之前虽然可以工作，但已经存在潜在问题。每次运行迁移时，EF Core 都会检测到模型变更，因为 DateTime.Now 每次都会返回不同的值。

EF Core 9.0 的变更

在 9.0 版本中，EF Core 团队增强了模型变更检测机制。当检测到模型存在未应用的变更时，系统会直接抛出错误，而不是像之前版本那样只是生成警告。这一变更使得问题更加明显，帮助开发者更早地发现潜在问题。

根本原因分析

EF Core 在生成迁移时会比较当前模型与上一次迁移时的模型状态。当种子数据中包含非确定性值（如 DateTime.Now、密码哈希等）时，每次比较都会得到不同的结果，导致 EF Core 认为模型发生了变更。

解决方案

针对这一问题，开发者可以采取以下几种解决方案：

1. 使用固定值替代动态值： 将 DateTime.Now 替换为固定的日期时间值，确保每次运行时值不变。

2. 考虑替代种子方法： 对于需要动态生成的数据，可以考虑使用初始化脚本或自定义初始化逻辑，而不是依赖 HasData() 方法。

3. 对于密码哈希等特殊场景： 如果确实需要在种子数据中包含哈希密码等动态生成的值，可以考虑：

   • 预先计算并存储固定值
   • 使用专门的初始化脚本
   • 实现自定义的数据库初始化逻辑

最佳实践

• 种子数据应尽量保持静态和确定性
• 对于需要动态生成的数据，考虑使用其他初始化方式
• 在团队协作环境中，确保种子数据的一致性
• 定期检查迁移历史，确保没有不必要的变更

总结

EF Core 9.0 的这一变更实际上是对长期存在问题的显式处理，虽然短期内可能会给一些开发者带来困扰，但从长远来看有助于提高数据一致性和可维护性。开发者应当理解这一变更背后的设计意图，并相应调整数据种子设定的策略。

记住，良好的数据种子策略应该具备确定性和可重复性，这是确保应用在不同环境中行为一致的关键因素之一。