.NET 7中使用Entity Framework Core自动创建数据库的方案选择

一、两种方法的核心差异 #

• EnsureCreated()

  • 直接基于当前DbContext的实体模型生成数据库，完全绕过EF的迁移系统。
  • 确实无法与迁移兼容：用此方法创建的数据库没有EF迁移历史表（__EFMigrationsHistory），后续无法通过Add-Migration或Update-Database命令添加/执行迁移，只能删除数据库后重新调用EnsureCreated()来更新结构。
  • 适用场景：快速原型开发、测试项目等不需要长期维护数据库结构的场景。

• Migrate()

  • 会执行所有未应用的迁移脚本，若数据库不存在，则先创建数据库再执行全部迁移。
  • 完全兼容迁移系统：数据库自动生成__EFMigrationsHistory表记录已执行的迁移，后续可以正常添加新迁移并更新数据库结构。
  • 适用场景：生产环境、需要长期迭代维护的专业应用，这也是行业通用的标准方案。

二、代码放置位置 #

不要将此逻辑写入DbContext内部，建议放在Program.cs（.NET 6+顶级语句模式）的应用启动流程中——这属于应用初始化逻辑，与DbContext的业务职责分离，结构更清晰。

三、最优方案：使用Migrate() #

对于专业应用，Migrate()是唯一推荐的方案，既能自动创建不存在的数据库，又能保证后续数据库结构迭代的兼容性。

实现代码（.NET 7 顶级语句模式） #

var builder = WebApplication.CreateBuilder(args);

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

var app = builder.Build();

// 在应用启动时执行迁移
using (var scope = app.Services.CreateScope())
{
    var dbContext = scope.ServiceProvider.GetRequiredService<YourDbContext>();
    dbContext.Database.Migrate();
}

// 其他中间件配置
app.MapControllers();
app.Run();

注意事项 #

1. 必须先通过Add-Migration InitialCreate命令创建初始迁移脚本，否则Migrate()没有可执行的迁移内容，数据库不会被创建。
2. 确保appsettings.json中配置了正确的连接字符串：

{
  "ConnectionStrings": {
    "DefaultConnection": "Server=(localdb)\\mssqllocaldb;Database=YourDatabaseName;Trusted_Connection=True;MultipleActiveResultSets=true"
  }
}

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