C#怎么创建EF Core种子数据_C# HasData初始化数据方法教程【实战】

用过 EF Core 的人，或多或少都接触过 HasData 这个方法。它的本意是给数据库“预填”一些种子数据，比如基础的产品分类、初始的用户角色之类。但这里有个关键点很多人容易忽略：HasData 并不是一个通用的“初始化数据”入口，它只在迁移（migration）生成和应用时起作用，而且只对首次创建表结构生效。换句话说，你直接调用 Sa veChanges 或者重启程序，都不会触发它重新插入、覆盖或校验这些数据。

HasData 必须配合迁移使用，否则无效

理解这一点很关键。HasData 定义的数据会被 EF Core 记录进迁移文件的 Up(MigrationBuilder migrationBuilder) 方法里，生成类似这样的代码：

migrationBuilder.InsertData(
    table: "Products",
    columns: new[] { "Id", "Name", "Price" },
    values: new object[] { 1, "测试产品1", 99.99m });

这意味着什么？如果你没运行过 dotnet ef migrations add，或者迁移文件被人为删掉了，那 HasData 就只是一段无害的 C# 代码，压根不会写入数据库。即使你后续改了 HasData 里的对象，也必须再执行一次 dotnet ef migrations add，才能生成对应的 UpdateData 或 DeleteData 操作。

一个常见的错误现象是：HasData 明明写好了，但数据库里空空如也。这时候可以按下面几步排查：

• 检查是否漏掉了 dotnet ef database update 这一步
• 打开迁移文件（.cs 文件），搜索 InsertData，看看有没有生成对应的调用
• 确认连接字符串指向的数据库，是不是被迁移命令操作到了——比如误连了 LocalDB 却在查 Sqlite

主键值必须显式指定，自增列也不能例外

这是很多新手容易踩的坑。EF Core 要求 HasData 中每个实体的主键字段都必须有确定值，哪怕该列是 IDENTITY 或 SERIAL 也不例外。否则你会看到这样的报错：System.InvalidOperationException: The seed entity for entity type 'Product' cannot be added because it has the property 'Id' set to default value.

这不是 bug，而是设计约束：迁移脚本需要明确知道要插入哪几行数据，不能依赖数据库在运行时生成 ID。比如这样写是没问题的：

modelBuilder.Entity().HasData(
    new Product { Id = 1, Name = "Laptop", Price = 1299.99m },
    new Product { Id = 2, Name = "Mouse", Price = 29.99m });

但如果你这样写：

new Product { Name = "Keyboard" } // Id 默认为 0 → 触发上述异常

就会触发异常。如果你真想让某列由数据库生成（比如 SQL Server 的 IDENTITY），仍然需要给 HasData 提供一个临时 ID。不过更稳妥的做法是，避免用自增列做 HasData 的主键，改用 GUID 或业务主键。

多实体关联时，外键值必须提前对齐

HasData 不支持跨实体自动解析导航属性，它只认外键字段（比如 CategoryId），不认引用对象（比如 Category = new Category { Id = 5 }）。

举个例子，这样写没问题：

modelBuilder.Entity().HasData(new Product { Id = 1, CategoryId = 5 });
modelBuilder.Entity().HasData(new Category { Id = 5, Name = "Electronics" });

但如果把 Category 的 HasData 放在 Product 后面，EF Core 在生成迁移时可能因为顺序问题报错，尤其是在涉及级联约束的情况下。所以实操建议是：

• 先定义被引用方（如 Category），再定义引用方（如 Product）
• 所有外键字段值必须真实存在——CategoryId = 5 对应的 Category.Id = 5 必须也在 HasData 中
• 中间表（多对多）也要显式提供两列外键值，例如：

  modelBuilder.Entity().HasData(
      new ProductTag { ProductId = 1, TagId = 101 });

HasData 看起来简单，实际上它是迁移系统的一部分，不是运行时逻辑。它不校验业务规则、不触发验证、不走 DbContext.Sa veChanges 流程——本质上，它只是一段被编译进迁移脚本的静态数据声明。真正容易被忽略的点是：你改了 HasData，却忘了重新生成迁移，那改动就等于没写。