HasData仅在EF Core迁移中生效，需配合dotnet ef migrations add和database update使用，主键必须显式指定，外键需提前对齐，不支持运行时校验或自动解析导航属性。
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。
-
正确写法示例：
modelBuilder.Entity<Product>().HasData( new Product { Id = 1, Name = "Laptop", Price = 1299.99m }, new Product { Id = 2, Name = "Mouse", Price = 29.99m }); -
错误写法（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 的
HasData放在 Product 后面，EF Core 在生成迁移时可能因顺序问题报错（尤其涉及级联约束时）。 -
实操建议：
- 先定义被引用方（如
Category），再定义引用方（如Product） - 所有外键字段值必须真实存在（即
CategoryId = 5对应的Category.Id = 5必须也在HasData中） - 中间表（多对多）也要显式提供两列外键值，例如：
modelBuilder.Entity<ProductTag>().HasData( new ProductTag { ProductId = 1, TagId = 101 });
- 先定义被引用方（如
HasData 看似简单，实际是迁移系统的一部分，不是运行时逻辑。它不校验业务规则、不触发验证、不走 DbContext.SaveChanges 流程——它只是一段被编译进迁移脚本的静态数据声明。真正容易被忽略的点是：你改了 HasData，却忘了重新生成迁移，那改动就等于没写。
