FluentMigrator 7.0.0 发布：数据库迁移框架的重大更新

项目简介

FluentMigrator 是一个流行的 .NET 数据库迁移框架，它允许开发者使用代码定义数据库架构变更，并通过版本控制来管理数据库演进。与传统的 SQL 脚本相比，FluentMigrator 提供了更结构化、更可维护的方式来处理数据库变更，特别适合在持续集成/持续交付(CI/CD)环境中使用。

主要更新内容

平台支持调整

FluentMigrator 7.0.0 版本对 .NET 平台支持进行了重要调整：

1. 新增了对 .NET 9.0 的支持
2. 移除了对已停止维护的 .NET 6.0 和 .NET 7.0 的支持
3. 全面支持 .NET 8.0

这一变化反映了项目紧跟微软技术栈的步伐，确保用户能够使用最新的 .NET 平台功能。

测试基础设施升级

7.0.0 版本引入了一个详细的集成测试套件，该套件在由各大数据库供应商提供的 Docker 容器镜像上运行测试。这一改进：

• 提高了测试覆盖率
• 确保了跨不同数据库提供商的兼容性
• 使问题重现和调试更加容易

重要功能改进

1. MySQL 相关改进：

   • 添加了对 typeMap 注入的支持
   • 修复了 MySQL 8 中列重命名语法的问题
   • 修正了 AddMySql8 的 XML 文档

2. MSBuild 集成增强：

   • 改进了 MicrosoftBuildLogger
   • 添加了 AllowDirtyAssemblies 开关
   • 优化了示例项目配置

3. 依赖注入改进：

   • 现在支持在 AddFluentMigratorCore 调用之前自定义注册 IVersionTableMetaData

4. 生成器改进：

   • 使用数据库函数设置 AppliedOn 的值，特别有助于需要 DBA 审核脚本的生产环境

废弃代码清理

作为主要版本更新，7.0.0 清理了大量已标记为废弃(Obsolete)的代码，这些代码已被废弃长达7年之久。清理内容包括：

• 删除 DeleteIndexExpressionBuilder.CurrentColumn
• 移除 IAssemblyCollection 及相关废弃构造函数/属性
• 移除大部分 LegacyExtensions 功能
• 删除 IMigrationRunner.RunnerContext 和 MigrationRunner.RunnerContext
• 移除 DefaultConventionSet 上的废弃构造函数

这些清理工作使代码库更加简洁，减少了维护负担。

技术细节解析

数据库函数应用时间戳

在版本控制表中，AppliedOn 字段现在使用数据库函数来设置值，而不是应用程序代码。这一变化带来了几个优势：

1. 确保时间戳的一致性，不受应用程序服务器时钟偏差影响
2. 使预览脚本更准确，特别适合需要 DBA 审核的环境
3. 减少了应用程序与数据库之间的耦合

测试容器化

新的测试基础设施使用 TestContainers 来管理数据库容器，这带来了：

1. 更真实的测试环境，接近生产配置
2. 支持多种数据库版本的并行测试
3. 简化了本地开发和 CI 环境中的测试设置

MySQL 类型映射注入

通过支持 typeMap 注入，用户现在可以：

1. 自定义 MySQL 数据类型映射
2. 适应特定的数据库配置需求
3. 更容易地支持 MySQL 的特殊数据类型

升级建议

对于计划升级到 7.0.0 版本的用户，建议：

1. 首先确保应用程序已迁移到 .NET 8.0 或更高版本
2. 检查是否使用了任何已移除的废弃 API，并进行相应调整
3. 在测试环境中充分验证迁移过程
4. 对于 MySQL 用户，特别注意列重命名语法的变化

未来展望

FluentMigrator 7.0.0 为未来的发展奠定了坚实基础。项目团队特别期待社区能在以下方面提供帮助：

1. 完善文档系统
2. 自动化文档发布流程
3. 补充缺失的 MSDoc 注释

这次更新展示了 FluentMigrator 项目对质量、现代化和开发者体验的持续承诺，为 .NET 生态中的数据库迁移需求提供了更加强大和可靠的解决方案。