从EF6迁移至EF Core 8：兼容既有库与全新部署的方案问询

核心需求复盘 #

• 基于.NET 8彻底移除EF6，改用EF Core迁移
• 兼容200+已部署的EF6数据库（禁止重建）
• 支持全新安装自动创建表结构
• 避免增加客户本地部署的手动操作步骤

可行方案 #

方案一：改造初始迁移的条件执行逻辑 #

1. 生成匹配EF6 schema的EF Core初始迁移
   先通过反向工程生成与现有EF6数据库完全一致的DbContext和实体类：

   Scaffold-DbContext "Server=.;Database=YourDb;Trusted_Connection=True;" Microsoft.EntityFrameworkCore.SqlServer -OutputDir Models -Context YourDbContext
   

   再生成初始迁移（不要直接应用）：

   Add-Migration InitialFromEF6
   

2. 批量修改迁移的Up方法，添加表存在判断
   打开生成的InitialFromEF6迁移文件，将每个CreateTable调用包裹在SQL Server的IF NOT EXISTS块中，无需手动编写每个表的创建SQL，直接复用迁移生成的语句：

   protected override void Up(MigrationBuilder migrationBuilder)
   {
       // 示例：改造单个表的创建逻辑
       migrationBuilder.Sql(@"
   

IF NOT EXISTS (SELECT * FROM sys.tables WHERE name = 'Users' AND schema_id = SCHEMA_ID('dbo'))
BEGIN
CREATE TABLE [dbo].[Users] (
[Id] int NOT NULL IDENTITY,
[Name] nvarchar(max) NOT NULL,
CONSTRAINT [PK_Users] PRIMARY KEY ([Id])
);
END");

// 对所有200+表重复上述逻辑（可用IDE批量替换工具快速处理生成的迁移代码）
   // 原迁移中的索引、外键等操作也需添加类似的存在判断

}

利用IDE的正则表达式批量替换功能，可快速完成所有表的条件创建改造，无需逐行手动修改。

### 方案二：启动时混合使用EnsureCreated与迁移（更简洁）
无需修改迁移文件，直接在服务启动逻辑中做分支处理：
```csharp
public static void InitializeDatabase(IApplicationBuilder app)
{
 using var scope = app.ApplicationServices.CreateScope();
 var context = scope.ServiceProvider.GetRequiredService<YourDbContext>();

 // 检查EF Core迁移历史表是否存在
 var hasMigrationHistory = context.Database.ExecuteSqlRaw(
     "SELECT COUNT(*) FROM sys.tables WHERE name = '__EFMigrationsHistory' AND schema_id = SCHEMA_ID('dbo')") > 0;

 if (!hasMigrationHistory)
 {
     // 全新安装：用EnsureCreated快速创建所有表（跳过迁移流程）
     context.Database.EnsureCreated();
     // 手动插入初始迁移记录，避免后续迁移重复执行
     context.Database.ExecuteSqlRaw(@"
INSERT INTO __EFMigrationsHistory (MigrationId, ProductVersion)
VALUES ('20240520000000_InitialFromEF6', '8.0.0')");
 }
 else
 {
     // 既有数据库：直接执行EF Core迁移（会自动跳过已存在的表结构操作）
     context.Database.Migrate();
 }
}

在Program.cs中调用这个初始化方法：

var app = builder.Build();
// 初始化数据库
InitializeDatabase(app);
// ... 其他中间件配置

验证要点 #

• 既有数据库：启动后检查__EFMigrationsHistory表是否新增了初始迁移记录，现有表结构无变更
• 全新安装：启动后自动创建所有表及迁移历史，后续新增迁移可正常执行

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