如何通过C#代码执行EF Core的InitialMigration且仅在空数据库时运行？

嘿，针对你提到的需求——把Add-Migration InitialMigration和Update-Database转成C#代码，只在数据库为空时执行，同时支持无代码部署时从空库构建模型，我整理了一套实用的方案：

一、C#代码实现：仅为空数据库执行迁移 #

首先我们要解决的是判断数据库是否为空，然后只在这种情况下执行迁移操作。这里提供两种判断逻辑，你可以根据自己的场景选择：

1. 检查迁移历史表是否存在（推荐） #

EF Core迁移会自动创建__EFMigrationsHistory表来记录迁移记录，所以如果这个表不存在，说明数据库从未执行过迁移，是空的。代码如下：

using Microsoft.EntityFrameworkCore;

public static async Task ApplyMigrationsIfEmptyAsync(DbContext yourDbContext)
{
    // 先确认数据库能正常连接
    var canConnect = await yourDbContext.Database.CanConnectAsync();
    if (!canConnect)
    {
        // 数据库都不存在，直接创建并执行迁移
        await yourDbContext.Database.MigrateAsync();
        Console.WriteLine("数据库不存在，已创建并完成初始化迁移");
        return;
    }

    // 检查__EFMigrationsHistory表是否存在（SQL Server语法，其他数据库需调整）
    var hasMigrationHistory = await yourDbContext.Database.ExecuteSqlRawAsync(
        "SELECT COUNT(*) FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA = 'dbo' AND TABLE_NAME = '__EFMigrationsHistory'") > 0;

    if (!hasMigrationHistory)
    {
        await yourDbContext.Database.MigrateAsync();
        Console.WriteLine("空数据库已完成迁移初始化");
    }
    else
    {
        Console.WriteLine("数据库已有迁移记录，跳过初始化操作");
    }
}

2. 严格检查是否无任何用户表 #

如果你需要更严格的“空数据库”定义（比如数据库存在但没有任何业务表），可以用这个逻辑：

public static async Task ApplyMigrationsIfTrulyEmptyAsync(DbContext yourDbContext)
{
    var canConnect = await yourDbContext.Database.CanConnectAsync();
    if (!canConnect)
    {
        await yourDbContext.Database.MigrateAsync();
        Console.WriteLine("数据库不存在，已创建并完成迁移");
        return;
    }

    // 统计dbo下的用户表数量（排除SQL Server的sysdiagrams系统表，其他数据库可调整）
    var userTableCount = await yourDbContext.Database.ExecuteSqlRawAsync(
        @"SELECT COUNT(*) 
          FROM INFORMATION_SCHEMA.TABLES 
          WHERE TABLE_TYPE = 'BASE TABLE' 
          AND TABLE_SCHEMA = 'dbo' 
          AND TABLE_NAME NOT IN ('sysdiagrams')");

    if (userTableCount == 0)
    {
        await yourDbContext.Database.MigrateAsync();
        Console.WriteLine("空数据库已完成迁移初始化");
    }
    else
    {
        Console.WriteLine("数据库已有用户表，跳过初始化");
    }
}

3. 在应用启动时调用 #

比如在ASP.NET Core的Program.cs里，你可以这么集成：

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>();
    await ApplyMigrationsIfEmptyAsync(dbContext);
}

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

二、无代码部署：从空数据库构建模型 #

因为部署时不带代码，你需要提前把迁移转换成SQL脚本，部署时直接执行脚本初始化数据库，这样数据库就能自动构建出对应的模型结构：

1. 生成迁移SQL脚本 #

用包管理器控制台或者.NET CLI生成从空数据库到InitialMigration的完整SQL脚本：

# 包管理器控制台
Script-Migration -From 0 -To InitialMigration -Output InitialMigration.sql

或者用.NET CLI：

dotnet ef migrations script 0 InitialMigration -o InitialMigration.sql

这个脚本包含了创建所有表（包括__EFMigrationsHistory）的所有SQL语句，直接执行就能把空库变成带模型结构的数据库。

2. 部署时执行脚本 #

在你的CI/CD部署流程里，先创建好空数据库，然后执行生成的InitialMigration.sql脚本就行。这样就算没有应用代码，数据库也能被正确初始化。

3. 关于运行时模型构建 #

如果你的应用运行时需要访问模型，但又不想部署代码，最稳妥的方式是提前用EF Core的反向工程（Scaffold-DbContext）从已迁移的数据库生成模型代码，然后把模型代码打包部署。如果一定要动态构建，那得自己实现模型的序列化/反序列化，这个比较复杂，不推荐。

三、一些注意点 #

• 确保数据库连接字符串有足够的权限（创建表、修改Schema等）。
• 不同数据库（MySQL、PostgreSQL等）的信息模式查询语句不一样，比如PostgreSQL的schema默认是public，需要调整SQL里的TABLE_SCHEMA值。
• 多环境部署时，要保证每个环境的初始化逻辑一致，避免重复执行迁移导致冲突。

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