C#怎么创建EF Core种子数据_C# HasData初始化数据方法教程【实战】-C#.Net教程-PHP中文网

HasData仅在EF Core迁移中生效，需配合dotnet ef migrations add和database update使用，主键必须显式指定，外键需提前对齐，不支持运行时校验或自动解析导航属性。

c#怎么创建ef core种子数据_c# hasdata初始化数据方法教程【实战】

HasData 不是“初始化数据”的通用入口，它只在迁移（migration）生成和应用时起作用，且仅对首次创建表结构生效。直接调用 SaveChanges 或重启程序不会重新插入、覆盖或校验这些数据。

`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
- 检查迁移文件里有没有生成 InsertData 调用（打开 .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。

正确写法示例：

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载

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

错误写法（Id 为 0）：

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

如果你真想让某列由数据库生成（比如 SQL Server 的 IDENTITY），仍需给 HasData 提供一个临时 ID，EF Core 会在迁移中把它当“占位 ID”处理；但更稳妥的做法是避免用自增列做 HasData 主键，改用 GUID 或业务主键。

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

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

如果你写：

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

那没问题；但如果你把 Category 的 HasData 放在 Product 后面，EF Core 在生成迁移时可能因顺序问题报错（尤其涉及级联约束时）。

实操建议：
- 先定义被引用方（如 Category），再定义引用方（如 Product）
- 所有外键字段值必须真实存在（即 CategoryId = 5 对应的 Category.Id = 5 必须也在 HasData 中）
- 中间表（多对多）也要显式提供两列外键值，例如：
```
modelBuilder.Entity<producttag>().HasData(
    new ProductTag { ProductId = 1, TagId = 101 });</producttag>
```

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