从开发到生产：EF Core数据迁移全流程实战指南-优快云博客

从开发到生产：EF Core数据迁移全流程实战指南

【免费下载链接】efcore efcore: 是 .NET 平台上一个开源的对象关系映射（ORM）框架，用于操作关系型数据库。适合开发者使用 .NET 进行数据库操作，简化数据访问和持久化过程。项目地址: https://gitcode.com/GitHub_Trending/ef/efcore

你是否还在为不同环境间的数据迁移而头疼？从开发环境到测试再到生产，如何确保数据库结构变更安全可靠？本文将带你掌握EF Core数据迁移的完整流程，解决环境差异导致的迁移难题，实现一键式数据库同步。

迁移基础：理解EF Core数据迁移

EF Core（Entity Framework Core）数据迁移（Migration）是.NET平台上用于管理数据库结构变更的工具，通过代码描述数据库模式的演化过程，支持版本控制和多环境同步。核心组件包括：

迁移类：包含Up()和Down()方法，分别定义正向和回滚操作
迁移构建器：用于创建表、添加列等数据库对象的API
快照文件：记录当前模型状态，用于检测后续变更

官方文档：docs/getting-and-building-the-code.md

迁移工作原理

EF Core迁移基于模型优先（Model-First）思想，通过对比当前实体模型与快照文件的差异，自动生成迁移代码。迁移历史记录存储在__EFMigrationsHistory表中，确保每次变更可追溯：

CREATE TABLE [__EFMigrationsHistory] (
    [MigrationId] nvarchar(150) NOT NULL,
    [ProductVersion] nvarchar(32) NOT NULL,
    CONSTRAINT [PK___EFMigrationsHistory] PRIMARY KEY ([MigrationId])
)

环境配置：多环境迁移策略

不同环境（开发/测试/生产）通常需要不同的数据库连接和迁移策略，通过配置文件分离实现环境隔离。

配置文件结构

在项目中创建多环境配置文件：

appsettings.json          // 基础配置
appsettings.Development.json  // 开发环境
appsettings.Production.json   // 生产环境

开发环境配置示例：

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

生产环境配置示例：

{
  "ConnectionStrings": {
    "DefaultConnection": "Server=prod-sql;Database=ProdDb;User Id=sa;Password=***"
  },
  "Migrations": {
    "ApplyMigrationsAtStartup": false  // 生产环境禁用自动迁移
  }
}

迁移实战：从零开始的迁移流程

1. 安装EF Core工具

首先安装EF Core命令行工具：

dotnet tool install --global dotnet-ef

工具源码：src/dotnet-ef/

2. 创建初始迁移

假设我们有一个Blog实体类：

public class Blog
{
    public int Id { get; set; }
    public string Title { get; set; }
    public string Content { get; set; }
}

在DbContext中注册实体：

public class AppDbContext : DbContext
{
    public DbSet<Blog> Blogs { get; set; }
    
    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        optionsBuilder.UseSqlServer(
            Configuration.GetConnectionString("DefaultConnection"));
    }
}

创建首次迁移：

dotnet ef migrations add InitialCreate

生成的迁移类位于Migrations目录，关键代码如下：

protected override void Up(MigrationBuilder migrationBuilder)
{
    migrationBuilder.CreateTable(
        name: "Blogs",
        columns: table => new
        {
            Id = table.Column<int>(type: "int", nullable: false)
                .Annotation("SqlServer:Identity", "1, 1"),
            Title = table.Column<string>(type: "nvarchar(max)", nullable: true),
            Content = table.Column<string>(type: "nvarchar(max)", nullable: true)
        },
        constraints: table =>
        {
            table.PrimaryKey("PK_Blogs", x => x.Id);
        });
}

迁移类示例：test/EFCore.SqlServer.HierarchyId.Tests/TestModels/Migrations/AnonymousArraySeedContext.cs

3. 应用迁移到数据库

执行以下命令将迁移应用到当前环境数据库：

dotnet ef database update

对于生产环境，建议生成SQL脚本进行审核后执行：

dotnet ef migrations script --idempotent --output Migrations/script.sql

此命令生成的SQL脚本具有幂等性，可安全重复执行。

高级技巧：处理复杂迁移场景

数据迁移与架构变更

当需要同时变更架构和迁移数据时，使用Sql()方法执行原始SQL：

protected override void Up(MigrationBuilder migrationBuilder)
{
    // 添加新列
    migrationBuilder.AddColumn<string>(
        name: "Slug",
        table: "Blogs",
        type: "nvarchar(255)",
        nullable: true);
        
    // 迁移数据
    migrationBuilder.Sql(
        "UPDATE Blogs SET Slug = LOWER(REPLACE(Title, ' ', '-'))");
        
    // 添加约束
    migrationBuilder.AlterColumn<string>(
        name: "Slug",
        table: "Blogs",
        type: "nvarchar(255)",
        nullable: false);
        
    migrationBuilder.CreateIndex(
        name: "IX_Blogs_Slug",
        table: "Blogs",
        column: "Slug",
        unique: true);
}

环境特定迁移

通过条件编译处理环境特定逻辑：

protected override void Up(MigrationBuilder migrationBuilder)
{
    migrationBuilder.CreateTable(
        name: "Blogs",
        columns: table => new
        {
            Id = table.Column<int>(type: "int", nullable: false)
                .Annotation("SqlServer:Identity", "1, 1"),
            Title = table.Column<string>(type: "nvarchar(max)", nullable: false)
        },
        constraints: table =>
        {
            table.PrimaryKey("PK_Blogs", x => x.Id);
        });
        
#if DEBUG
    // 仅开发环境添加测试数据
    migrationBuilder.InsertData(
        table: "Blogs",
        columns: new[] { "Title" },
        values: new object[] { "测试文章1", "测试文章2" });
#endif
}

迁移回滚策略

使用Down()方法定义回滚操作，确保可以安全撤销迁移：

protected override void Down(MigrationBuilder migrationBuilder)
{
    migrationBuilder.DropIndex(
        name: "IX_Blogs_Slug",
        table: "Blogs");
        
    migrationBuilder.DropColumn(
        name: "Slug",
        table: "Blogs");
}

执行回滚命令：

dotnet ef database update InitialCreate  # 回滚到指定版本
# 或
dotnet ef migrations remove  # 删除最近一次迁移（未应用时）

最佳实践：迁移管理 checklist

版本控制：所有迁移文件必须纳入版本控制
测试覆盖：为迁移编写单元测试，验证数据一致性
备份策略：应用迁移前自动备份数据库
CI/CD集成：在CI管道中验证迁移可行性
文档更新：维护迁移变更日志，记录关键操作

测试示例：test/EFCore.SqlServer.HierarchyId.Tests/MigrationTests.cs

总结与展望

EF Core数据迁移提供了强大的数据库版本管理能力，通过本文介绍的流程和技巧，你可以：

安全管理多环境数据库变更
处理复杂的架构演化和数据迁移
生成审计友好的SQL脚本
实现自动化迁移流程

随着EF Core版本迭代，迁移功能不断增强，未来将支持更多高级特性如增量迁移和智能数据迁移。立即开始使用EF Core迁移，让数据库变更像代码一样可控！

点赞+收藏+关注，获取更多EF Core实战技巧。下期预告：《EF Core性能优化：迁移操作性能调优指南》

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考