共计 2025 个字符，预计需要花费 6 分钟才能阅读完成。
背景痛点
在传统的 C# 开发过程中，数据库表的创建和管理往往需要手动编写 SQL 脚本。这种方式存在几个明显的缺点：
- 容易出错：手动编写 SQL 时，字段类型、长度、约束等细节容易遗漏或写错
- 维护困难：当模型变更时需要手动修改 SQL 脚本，难以保持同步
- 效率低下：每次变更都需要重新编写并执行 SQL 脚本
- 版本控制困难：多人协作时难以跟踪数据库变更历史
技术选型对比
在.NET 生态中，主要有以下几种 ORM 工具可以实现数据库迁移：
- Entity Framework Core Migrations
- 官方维护，集成度高
- 支持多种数据库
- 提供完整的迁移历史管理
-
命令行工具成熟
-
Dapper
- 轻量级，性能高
- 需要手动管理数据库变更
-
不适合复杂的数据模型变更
-
NHibernate
- 功能强大
- 配置复杂
- 社区活跃度下降
综合来看，EF Core Migrations 在开发效率、维护成本和功能完整性方面具有明显优势。
核心实现细节
1. 模型定义
首先需要定义实体类，这些类将映射到数据库表。例如：
public class Product
{public int Id { get; set;}
public string Name {get; set;}
public decimal Price {get; set;}
public int Stock {get; set;}
}2. DbContext 配置
创建一个继承自 DbContext 的类，并在其中定义 DbSet 属性：
public class AppDbContext : DbContext
{public DbSet<Product> Products { get; set;}
protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{optionsBuilder.UseSqlServer("YourConnectionString");
}
}3. 安装 EF Core 工具
在项目目录下执行以下命令安装 EF Core 工具：
dotnet tool install --global dotnet-ef4. 创建迁移
使用以下命令创建迁移：
dotnet ef migrations add InitialCreate这条命令会：
- 分析当前模型与数据库的差异
- 生成迁移脚本文件
- 创建迁移快照
5. 应用迁移
使用以下命令将迁移应用到数据库：
dotnet ef database update完整代码示例
下面是一个完整的示例，包含模型定义、DbContext 配置和迁移命令：
// 模型定义
public class Customer
{public int Id { get; set;}
public string Name {get; set;}
public string Email {get; set;}
public DateTime RegisterDate {get; set;}
}
// DbContext 配置
public class AppDbContext : DbContext
{public DbSet<Customer> Customers { get; set;}
protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{optionsBuilder.UseSqlServer("Server=(localdb)\\mssqllocaldb;Database=MyDatabase;Trusted_Connection=True;");
}
}然后在命令行中执行：
dotnet ef migrations add InitialCreate
dotnet ef database update性能考量
- 迁移执行效率
- 对于大型数据库，迁移可能耗时较长
- 建议在低峰期执行
-
考虑分批执行大型迁移
-
并发问题处理
- 迁移执行期间应避免其他操作
- 可以使用数据库锁机制
-
考虑使用事务确保一致性
-
迁移脚本优化
- 合并多个小迁移
- 避免不必要的列重建
- 使用
AlterColumn代替DropColumn+AddColumn
生产环境避坑指南
常见错误及解决方案
- 迁移失败：表已存在
- 原因：重复执行迁移
-
解决：检查__EFMigrationsHistory 表
-
模型变更导致迁移失败
- 原因：模型与数据库不一致
-
解决：回滚迁移或手动调整数据库
-
并发迁移冲突
- 原因：多人同时添加迁移
-
解决：使用版本控制系统协调
-
外键约束问题
- 原因：删除或修改被引用的表 / 列
- 解决：先移除约束再修改
最佳实践
- 始终保持开发环境与生产环境数据库同步
- 每个功能分支创建独立的迁移
- 迁移前备份数据库
- 测试环境充分验证迁移脚本
- 编写回滚脚本备用
总结与思考
EF Core Migrations 提供了一种高效、可靠的数据库变更管理方式。通过将模型变更自动转换为数据库脚本，大大提高了开发效率并减少了人为错误。
未来可以考虑：
- 将迁移流程集成到 CI/CD 管道中
- 自动化测试迁移脚本
- 开发自定义迁移生成器
- 实现多环境差异化迁移
通过合理规划和使用 EF Core Migrations，可以使数据库变更管理变得更加轻松和安全。
正文完
