Fluent Migrator误将Version Info表建在master库致应用报错的修正方法
FluentMigrator 将
Version Info 元数据表写入 master 库的修复方案 问题核心原因
- 你配置的全局连接字符串漏写了
Initial Catalog参数,SQL Server 会默认把这类连接路由到当前登录账号的默认库,绝大多数场景下就是master系统库。FluentMigrator 读写用来追踪迁移状态的Version Info表时,完全用的是这个全局连接的默认库,和你迁移脚本里写多少遍USE siteDB没有任何关系。 - 你把「创建siteDB数据库」这个动作放到了FluentMigrator的受追踪迁移流程里,逻辑上就存在矛盾:FluentMigrator 一开始就要在目标库建
Version Info表,但这时候siteDB根本还不存在,最后只能顺着连接的默认库,把这个元数据表建到master里。 - 最终的错位结果就是:FluentMigrator 把已执行的迁移记录全存在master的
Version Info表里,等业务应用启动时,用指向siteDB的连接去查迁移状态,自然在siteDB里找不到对应的元数据表,直接抛异常崩溃。 - 额外说明:SqlClient执行SQL脚本时会把批处理拆成多个命令块,
USE语句的上下文只会在当前块生效,跨命令块执行时上下文会重置,这也是很多人写了USE 库名还是切换失败的原因。
调整步骤
1. 拆分流程职责,把建库动作移出FluentMigrator的追踪范围
FluentMigrator 天生不适合承担「创建目标数据库」的任务——毕竟这个动作发生在库存在之前,根本没法提前在不存在的库里建追踪表。
- 让FluentMigrator 只负责siteDB创建完成后,库内的表、视图、存储过程等业务对象的结构迁移
- 把原1610594913迁移里的建库、删库逻辑,移到程序启动的初始化阶段,用指向master的连接先完成siteDB的存在性检查和创建。
2. 修改FluentMigrator的连接字符串
把原来不带默认库的连接串,改成直接把siteDB设为连接的默认库:
string targetDbConnString = @"Server=localhost\SQLEXPRESS;Trusted_Connection=True;Initial Catalog=siteDB;";
因为建库的动作已经在初始化阶段提前跑完了,这个连接能正常连到siteDB,FluentMigrator 启动时会自动在siteDB里创建Version Info元数据表,再也不会写到master里。
3. 清理迁移脚本里的无效上下文语句
把原建表迁移里写的USE siteDB;全删掉。现在连接的默认库已经是siteDB,根本不需要手动切上下文,还能避免之前说的USE语句跨批处理块失效的问题。
调整后的建表迁移写法:
[Migration(1610594914)] public class CreateTablesMigation : Migration { public override void Down() { } public override void Up() { // 直接写siteDB下的对象创建语句,不需要带USE Execute.Sql(@" CREATE TABLE[AspNetRoles] ..."); } }
4. 清理之前的残留错误状态
之前测试时FluentMigrator 自动建在master里的那个Version Info表要手动删掉,不然里面存的历史迁移记录会让FluentMigrator误判迁移状态,出现明明迁移已经跑了但还提示要执行的问题。
调整后的完整可运行流程参考
static void Main(string[] args) { // 第一步:用master库的连接,提前建好siteDB string masterConnString = @"Server=localhost\SQLEXPRESS;Trusted_Connection=True;Initial Catalog=master;"; using (var conn = new SqlConnection(masterConnString)) { conn.Open(); using var checkCmd = conn.CreateCommand(); // siteDB不存在就自动创建,存在就跳过 checkCmd.CommandText = "IF DB_ID('siteDB') IS NULL CREATE DATABASE siteDB;"; checkCmd.ExecuteNonQuery(); } // 第二步:初始化指向siteDB的FluentMigrator服务 string targetDbConnString = @"Server=localhost\SQLEXPRESS;Trusted_Connection=True;Initial Catalog=siteDB;"; var serviceProvider = CreateServices(targetDbConnString); // 第三步:从服务容器取出迁移执行器,跑所有siteDB下的结构迁移 using var scope = serviceProvider.CreateScope(); var runner = scope.ServiceProvider.GetRequiredService<IMigrationRunner>(); runner.MigrateUp(); }
实操注意点
- 别指望靠迁移脚本里的
USE语句能改变Version Info表的存储位置,这个元数据表落在哪,完全由全局连接字符串的默认库决定。 - 生产环境不建议把「创建数据库」的动作放进FluentMigrator的追踪流程,库的创建/删除一般由运维流程管控,迁移脚本只管库内部的对象变更就行。
- 原代码里漏了从服务容器解析
IMigrationRunner实例的步骤,直接调用没初始化的runner会触发空引用,一定要通过依赖注入拿到实际的执行器实例再调用迁移方法。
内容的提问来源于stack exchange,提问作者Vladik
相关产品推荐
相关产品推荐

