Entity Framework Core生成空迁移文件问题求助

问题描述 #

使用Entity Framework Core 7创建数据库时，执行dotnet ef migrations add ExampleMigration命令生成的迁移文件仅包含空实现的Up()和Down()方法，项目编译正常。已尝试以下操作但未解决问题：

• 为上下文类添加virtual修饰符
• 删除上下文快照模型
• 删除并重建数据库

排查与解决方法 #

1. 验证DbContext的实体注册 #

确保DbContext类中通过DbSet<T>显式声明了所有需要映射的实体，或在OnModelCreating方法中通过Fluent API配置了实体：

public class AppDbContext : DbContext
{
    // 显式声明实体的DbSet
    public DbSet<User> Users { get; set; }

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        optionsBuilder.UseSqlServer("你的数据库连接字符串");
    }

    // 如果使用Fluent API，确保配置了实体
    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<User>(entity =>
        {
            entity.HasKey(e => e.Id);
            entity.Property(e => e.Name).IsRequired();
        });
    }
}

2. 确认EF Core工具的项目指向 #

执行迁移命令时，确保终端当前目录为包含DbContext的项目目录，或通过参数指定正确项目：

# 指定数据项目
dotnet ef migrations add ExampleMigration --project ./YourDataLibraryProject

# 如果DbContext在类库，需指定启动项目
dotnet ef migrations add ExampleMigration --project ./YourDataLibraryProject --startup-project ./YourWebOrConsoleProject

3. 检查实体类的主键配置 #

EF Core要求每个实体必须有主键（默认识别Id或[实体名]Id命名的属性），无主键的实体不会被EF Core识别为需要映射的对象：

public class User
{
    public int Id { get; set; } // 必须配置主键
    public string UserName { get; set; }
}

4. 彻底清理迁移文件后重新生成 #

删除Migrations文件夹下所有迁移文件（保留DesignTimeDbContextFactory等必要文件），再重新执行迁移命令：

dotnet ef migrations add ExampleMigration

5. 验证DbContext的依赖注入配置 #

如果采用依赖注入方式注册DbContext，确保在Program.cs中正确配置：

var builder = WebApplication.CreateBuilder(args);

// 注册DbContext
builder.Services.AddDbContext<AppDbContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection")));

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