在C#中使用EF Core的种子数据(Seed Data)功能,可以让你在数据库创建或迁移时自动插入初始数据。这适用于像角色、状态码、配置项等基础数据。EF Core 提供了多种方式来配置种子数据,推荐使用 模型构建器(OnModelCreating) 中的
HasData方法进行配置。
1. 使用 HasData 方法配置种子数据
在你的
DbContext子类中重写
OnModelCreating方法,并为需要初始化数据的实体调用
HasData。 示例:为一个表示“用户角色”的实体添加种子数据
public class AppDbContext : DbContext
{
public DbSet<Role> Roles { get; set; }
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
// 配置种子数据
modelBuilder.Entity<Role>().HasData(
new Role { Id = 1, Name = "Admin" },
new Role { Id = 2, Name = "User" },
new Role { Id = 3, Name = "Guest" }
);
}
}
注意: 被用于种子数据的实体必须有主键值(如上面的 Id),否则会抛出异常。
2. 种子数据与迁移配合使用
种子数据不会在每次应用启动时执行,而是通过 EF Core 的迁移机制管理。你需要生成一次迁移才能生效。
添加迁移:dotnet ef migrations add SeedRoles更新数据库:
dotnet ef database update
生成的迁移文件中会包含
InsertData或
UpdateData操作,确保数据被正确写入。
3. 更新已有种子数据
如果你修改了已存在的种子数据(比如把 "Admin" 改成 "Administrator"),再次生成迁移后,EF Core 会生成相应的
UpdateData操作来更新数据库中的记录。
例如:
modelBuilder.Entity<Role>().HasData(
new Role { Id = 1, Name = "Administrator" }, // 修改了名称
new Role { Id = 2, Name = "User" },
new Role { Id = 3, Name = "Guest" }
);
运行迁移命令后,数据库中 Id=1 的记录会被更新。
4. 处理关系数据时的注意事项
如果种子数据涉及外键关系,需确保主表数据的主键值明确且一致。
例如:用户角色和用户表关联时,用户的
RoleId应引用已定义的种子角色 Id。
modelBuilder.Entity<User>().HasData(
new User { Id = 1, Name = "Alice", RoleId = 1 },
new User { Id = 2, Name = "Bob", RoleId = 2 }
);
前提是 Role 表中 Id=1 和 Id=2 的记录已经通过
HasData定义。
基本上就这些。只要在
OnModelCreating中用
HasData写好初始数据,再通过迁移更新数据库,种子数据就能自动部署。不复杂但容易忽略的是主键必须显式指定,否则会失败。
