EF Core 6中EntityTypeBuilder.HasData()无法在迁移中生成种子数据

问题核心 #

实体配置类（实现IEntityTypeConfiguration<T>）中的HasData配置未被迁移工具识别，但在OnModelCreating中直接编写的种子数据可正常生成迁移，其他实体配置生效，说明配置类已被加载，问题出在种子数据的配置规范或迁移工具的扫描逻辑上。

解决步骤 #

1. 确保配置类被正确加载 #

在PlaygroundDbContext的OnModelCreating方法中，必须显式加载实体配置类：

• 手动加载单个配置类：

  modelBuilder.ApplyConfiguration(new CourseEntityConfiguration());
  

• 自动加载当前程序集内所有配置类：

  modelBuilder.ApplyConfigurationsFromAssembly(typeof(PlaygroundDbContext).Assembly);
  

注意：配置类需设为public，迁移工具无法访问internal类的配置内容。

2. 种子数据必须包含明确主键值 #

无论主键是否为自增类型，HasData中的种子数据必须显式指定主键：

public void Configure(EntityTypeBuilder<Course> builder)
{
    // 实体配置
    builder.HasKey(c => c.Id);
    builder.Property(c => c.Name).IsRequired().HasMaxLength(150);

    // 种子数据（必须指定Id）
    builder.HasData(
        new Course { Id = 1, Name = "数据结构" },
        new Course { Id = 2, Name = "操作系统" }
    );
}

若主键为自增（DatabaseGeneratedOption.Identity），EF Core会自动处理序列连续性，无需额外配置。

3. 清除迁移缓存并重新生成 #

迁移工具可能存在缓存，导致未识别配置类的变更：

• 删除项目下的Migrations文件夹（测试项目可直接操作）
• 执行迁移生成命令：

  dotnet ef migrations add UpdateCourseSeedData --project YourProjectName
  

  或在Package Manager Console中执行：

  Add-Migration UpdateCourseSeedData -Project YourProjectName
  

4. 检查DbContext构造函数配置 #

确保DbContext的构造函数正确接收配置参数并传递给基类：

public PlaygroundDbContext(DbContextOptions<PlaygroundDbContext> options) : base(options)
{
}

代码示例 #

实体配置类（CourseEntityConfiguration） #

using Microsoft.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore.Metadata.Builders;
using YourProject.Models;

public class CourseEntityConfiguration : IEntityTypeConfiguration<Course>
{
    public void Configure(EntityTypeBuilder<Course> builder)
    {
        builder.HasKey(c => c.Id);
        builder.Property(c => c.Name).IsRequired().HasMaxLength(150);

        builder.HasData(
            new Course { Id = 1, Name = "数据结构" },
            new Course { Id = 2, Name = "操作系统" }
        );
    }
}

DbContext类（PlaygroundDbContext） #

using Microsoft.EntityFrameworkCore;
using YourProject.Models;

public class PlaygroundDbContext : DbContext
{
    public DbSet<Course> Courses { get; set; }

    public PlaygroundDbContext(DbContextOptions<PlaygroundDbContext> options) : base(options)
    {
    }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.ApplyConfiguration(new CourseEntityConfiguration());
        // 或使用自动加载：modelBuilder.ApplyConfigurationsFromAssembly(typeof(PlaygroundDbContext).Assembly);
    }
}

内容的提问来源于stack exchange，提问作者RonRonDK