C#中如何使用HasData方法实现数据种子初始化

在C#的EntityFrameworkCore开发中，数据种子初始化是很多项目上线前需要完成的操作，通过HasData方法可以在数据库迁移时自动向表中插入预设的基础数据，比如系统默认角色、基础配置项等，避免手动逐条插入的繁琐。

环境准备

要实现HasData数据种子初始化，首先需要搭建EntityFrameworkCore的基础环境，这里以.NET 6及以上的控制台项目为例，需要安装以下NuGet包：

• Microsoft.EntityFrameworkCore.SqlServer（如果使用SQL Server数据库）
• Microsoft.EntityFrameworkCore.Tools（用于执行迁移命令）

定义实体类和数据库上下文

首先我们定义一个简单的用户角色实体类，后续会为这个实体初始化种子数据：

// 角色实体类
public class Role
{
    // 主键
    public int Id { get; set; }
    // 角色名称
    public string RoleName { get; set; }
    // 角色描述
    public string Description { get; set; }
}

接下来定义数据库上下文类，在上下文的OnModelCreating方法中配置种子数据：

using Microsoft.EntityFrameworkCore;

public class AppDbContext : DbContext
{
    // 角色表对应的DbSet
    public DbSet<Role> Roles { get; set; }

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        // 配置数据库连接字符串，这里使用本地SQL Server实例
        optionsBuilder.UseSqlServer("Server=localhost;Database=TestDb;Trusted_Connection=True;");
    }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        // 使用HasData方法配置Role表的种子数据
        modelBuilder.Entity<Role>().HasData(
            new Role
            {
                Id = 1,
                RoleName = "管理员",
                Description = "拥有系统全部权限的角色"
            },
            new Role
            {
                Id = 2,
                RoleName = "普通用户",
                Description = "仅拥有基础操作权限的角色"
            }
        );
    }
}

执行迁移生成种子数据

配置完成后，需要执行EntityFrameworkCore的迁移命令来将种子数据写入数据库：

首先在程序包管理器控制台中执行以下命令，生成迁移文件：

Add-Migration InitSeedData

执行完成后会生成一个迁移类，在迁移类的Up方法中可以看到自动生成的插入种子数据的SQL逻辑：

public partial class InitSeedData : Migration
{
    protected override void Up(MigrationBuilder migrationBuilder)
    {
        migrationBuilder.InsertData(
            table: "Roles",
            columns: new[] { "Id", "RoleName", "Description" },
            values: new object[,]
            {
                { 1, "管理员", "拥有系统全部权限的角色" },
                { 2, "普通用户", "仅拥有基础操作权限的角色" }
            });
    }

    protected override void Down(MigrationBuilder migrationBuilder)
    {
        migrationBuilder.DeleteData(
            table: "Roles",
            keyColumn: "Id",
            keyValue: 1);

        migrationBuilder.DeleteData(
            table: "Roles",
            keyColumn: "Id",
            keyValue: 2);
    }
}

之后执行更新数据库的命令，将迁移应用到数据库：

Update-Database

执行完成后，查看数据库中的Roles表，会发现两条预设的种子数据已经自动插入到表中。

HasData使用的注意事项

主键必须显式赋值

使用HasData插入种子数据时，必须显式为实体的主键属性赋值，否则迁移时会报错，因为EntityFrameworkCore需要明确的主键值来生成对应的插入语句。

数据更新的处理方式

如果需要修改已经存在的种子数据，直接修改HasData中的对应属性值后重新生成迁移即可，EntityFrameworkCore会自动生成更新语句，不需要手动删除旧数据再插入。

关联实体的种子数据

如果实体之间存在关联关系，比如用户实体关联角色实体，需要先初始化主表（角色表）的种子数据，再初始化从表（用户表）的种子数据，保证外键引用的主表数据已经存在。

常见问题解答

问：HasData只能在迁移时执行吗？

是的，HasData配置的种子数据会在执行数据库迁移时自动插入，不会在每次程序运行时重复插入，适合初始化固定不变的基础数据。

问：种子数据可以插入动态生成的值吗？

不可以，HasData中配置的数据必须是常量，不能使用方法调用或者动态计算的数值，否则迁移时会报错。

C#HasData数据种子初始化EntityFrameworkCore修改时间：2026-06-13 16:36:42