EF Core 9.0 迁移脚本中的SQL执行顺序问题解析

在EF Core 9.0版本中，当使用迁移脚本功能时，开发者可能会遇到一个关于SQL执行顺序的常见问题。这个问题表现为在执行包含自定义SQL语句的迁移脚本时，系统会报错"Invalid column name"，即使该列确实已经在迁移中被添加。

问题现象

在EF Core 9.0中，当我们创建一个包含以下内容的迁移脚本时：

1. 添加新列到现有表
2. 立即对该新列执行UPDATE操作

生成的脚本会将这些操作放在同一个事务块中，但SQL Server会一次性编译整个批处理语句，此时新列尚未真正创建，导致UPDATE语句找不到该列而报错。

技术原理

这个问题源于SQL Server的批处理编译机制。与早期版本不同，EF Core 9.0生成的迁移脚本不再使用GO语句分隔批处理，而是将所有操作放在一个事务中。SQL Server在执行前会先编译整个批处理，此时虽然ALTER TABLE语句在UPDATE之前，但编译时表结构尚未改变。

解决方案

有两种主要解决方法：

1. 使用EXEC包装SQL语句： 在迁移类中，将自定义SQL语句用EXEC()函数包装：

   migrationBuilder.Sql("EXEC('UPDATE Employees SET Department = ''IT''')");
   

2. 手动拆分批处理： 在生成的脚本中手动添加GO语句，将ALTER TABLE和UPDATE操作分隔到不同的批处理中。

版本差异说明

值得注意的是，这个问题在EF Core 8.0中不会出现，因为8.0生成的脚本会自动包含GO语句分隔批处理。这是EF Core 9.0的一个行为变更，开发者在升级时需要注意。

最佳实践建议

1. 对于包含表结构变更后立即操作新列的迁移，始终使用EXEC包装相关SQL
2. 在团队中统一迁移脚本的编写规范
3. 测试环境充分验证迁移脚本的执行效果
4. 考虑将复杂的迁移逻辑拆分为多个小迁移

通过理解这一问题的本质并采用适当的解决方案，开发者可以确保EF Core迁移脚本在各种环境下都能正确执行。