如何将EF Core迁移与产品发布版本关联？含程序化实现需求

EF Core默认按单个文件生成迁移，但要实现跨版本区间的批量升级/回滚（比如从101.1.03到101.1.14），可以通过以下方式落地：

一、迁移的版本化组织 #

• 给每个迁移类添加版本标记：可以自定义属性记录对应产品版本，或者直接在迁移名称中嵌入版本号，方便后续筛选：

  [Migration("20240520120000_InitialCreate")]
  [ProductVersion("101.1.03")] // 自定义属性需自行定义
  public partial class InitialCreate : Migration
  {
      // 迁移逻辑
  }
  

• 命名示例：直接用版本前缀命名迁移类，比如Migration_101_1_03_InitialCreate，简化版本解析逻辑。

二、编程方式实现区间迁移 #

1. 读取并排序所有迁移 #

通过EF Core的内置服务获取所有已定义的迁移，再按版本排序：

var migrationsAssembly = serviceProvider.GetRequiredService<IMigrationsAssembly>();
var allMigrations = migrationsAssembly.Migrations.Values
    .Select(m => new 
    {
        Migration = m,
        Version = ExtractVersion(m) // 自行实现：从自定义属性或迁移名称中解析版本
    })
    .OrderBy(m => m.Version)
    .ToList();

2. 筛选目标区间的迁移 #

根据当前数据库版本和目标版本，筛选出需要执行的迁移集合：

var currentDbVersion = GetCurrentDbVersion(serviceProvider); // 从数据库迁移记录表读取当前版本
var targetVersion = new Version("101.1.14");

var migrationsToApply = allMigrations
    .Where(m => m.Version > currentDbVersion && m.Version <= targetVersion)
    .Select(m => m.Migration)
    .ToList();

3. 批量执行升级 #

使用MigrationExecutor逐个执行筛选后的迁移：

var executor = serviceProvider.GetRequiredService<MigrationExecutor>();
foreach (var migration in migrationsToApply)
{
    await executor.MigrateAsync(migration.TargetMigration, cancellationToken);
}

4. 区间回滚实现 #

回滚时反向筛选区间，按版本逆序执行回滚：

var migrationsToRollback = allMigrations
    .Where(m => m.Version <= currentDbVersion && m.Version > targetVersion)
    .OrderByDescending(m => m.Version)
    .Select(m => m.Migration)
    .ToList();

foreach (var migration in migrationsToRollback)
{
    await executor.RollbackAsync(migration.TargetMigration, cancellationToken);
}

三、关键注意事项 #

• 确保版本标记唯一且严格有序，避免版本冲突。
• 复杂迁移需手动完善Down方法，保证回滚逻辑的正确性。
• 可将版本解析、区间筛选逻辑封装成工具类，方便多场景复用。

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