EntityFramework Core 9.0 迁移脚本中的列名无效问题解析

在EntityFramework Core 9.0版本中，开发者在执行迁移脚本时可能会遇到"Invalid column name"（无效列名）的错误。这个问题通常出现在使用dotnet ef migrations script --idempotent命令生成脚本后执行时。

问题现象

当开发者按照以下步骤操作时会出现问题：

1. 创建一个包含简单实体（如Employee）的初始迁移
2. 添加一个新属性（如Department）并创建第二个迁移
3. 在迁移中添加自定义SQL语句（如UPDATE语句）
4. 使用idempotent参数生成迁移脚本

执行生成的脚本时，SQL Server会报告"Invalid column name"错误，指出找不到新添加的列名。

问题原因

这个问题的根本原因在于SQL Server的批处理执行机制。在生成的idempotent脚本中，ALTER TABLE添加列和后续的UPDATE语句被放在同一个批处理中执行，但SQL Server在编译整个批处理时就会检查所有列名是否存在，而此时新列尚未被创建。

解决方案

有两种主要解决方法：

1. 使用EXEC包装SQL语句： 将迁移中的自定义SQL语句用EXEC()函数包装，这样SQL Server会在运行时才解析语句内容：

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

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

版本差异说明

这个问题在EF Core 8.0中不会出现，因为8.0生成的脚本中会自动包含GO语句分隔批处理。9.0版本中移除了这个行为，导致问题重现。

最佳实践建议

1. 当迁移中包含依赖新列的自定义SQL时，总是使用EXEC包装
2. 在团队中统一迁移脚本的编写规范
3. 测试环境充分验证迁移脚本的执行效果
4. 考虑将复杂的数据迁移拆分为单独的迁移步骤

总结

理解SQL Server的批处理编译机制对于编写可靠的迁移脚本至关重要。虽然EF Core提供了强大的迁移功能，但在处理复杂场景时仍需要开发者对底层数据库行为有基本了解。通过使用EXEC或合理分隔批处理，可以确保迁移脚本在各种环境下都能正确执行。