EF Core种子数据需在OnModelCreating中用HasData配置并配合迁移生效,主键必须显式赋值,修改后须重新生成并应用迁移才能同步到数据库。

EF Core 的种子数据(Seeding Data)不是运行时自动执行的初始化逻辑,而是通过迁移机制写入数据库的静态初始数据。核心配置方式就是 在 OnModelCreating 中调用 HasData,但必须配合迁移才能生效。
种子数据必须在 OnModelCreating 中配置
只能在 DbContext 子类的 OnModelCreating 方法里为实体添加种子数据,不能放在构造函数、OnConfiguring 或启动时手动插入。
- 每个要填充种子的实体,需显式调用
modelBuilder.Entity().HasData(...) - 主键字段(如
Id)必须赋值,即使它是自增列——EF Core 种子机制不支持自动生成主键值 - 支持传入对象实例、匿名对象或对象数组,例如:
HasData(new Role { Id = 1, Name = "Admin" })或HasData(new[] { ..., ... })
必须生成并应用迁移才能写入数据库
HasData 只是“声明”,不会在程序启动时自动执行。它会被 EF Core 编译进迁移文件,只有运行迁移命令才会真正操作数据库。
- 添加迁移:
dotnet ef migrations add SeedInitialData - 更新数据库:
dotnet ef database update - 查看生成的迁移文件,你会看到
InsertData或UpdateData调用,对应你写的 HasData 内容
更新种子数据要重新生成迁移
修改了 HasData 里的数据(比如改了角色名、新增了一条记录),不会自动同步到库中。必须再执行一次迁移命令,EF Core 才会对比差异,生成 UpdateData 或补 InsertData。
- 例如把
Name = "Admin"改成"Administrator",再次迁移后,数据库中该行会被更新 - 如果删掉某条 HasData 记录,默认不会从数据库删除——EF Core 不做“反向清理”。如需删除,得手动在迁移中加
DeleteData,或用其他方式管理
关联数据要注意主键一致性
当多个实体存在外键关系(如 User → Role),种子数据必须保证引用完整性。
- 先定义被引用实体(如 Role)的种子,明确写出
Id - 再在引用方(如 User)中使用相同的
RoleId值,例如:new User { Id = 1, Name = "Alice", RoleId = 1 } - 避免用 Guid 或随机数作主键值,否则难以维护引用关系
基本上就这些。不复杂但容易忽略——重点就三点:主键必须写死、必须走迁移、改了就得再迁。










