EntityFramework Core 9 迁移事务行为变更解析

事务性迁移的兼容性问题

在 EntityFramework Core 9.0 版本中，微软对数据库迁移的事务处理机制进行了重要调整，这导致了一些在 EF Core 8 中正常工作的迁移代码在升级后出现异常。本文将深入分析这一变更的技术背景、影响范围以及解决方案。

问题现象

开发者在 EF Core 9 中执行数据库迁移时，可能会遇到以下异常：

System.NotSupportedException: User transaction is not supported with a TransactionSuppressed migrations or a retrying execution strategy.

这种异常通常出现在以下场景：

1. 使用外部事务包裹多个 DbContext 的迁移操作
2. 在测试环境中并行执行迁移
3. 显式创建事务后调用 MigrateAsync 方法

技术背景

EF Core 9 引入了更严格的迁移事务控制机制，主要出于两个目的：

1. 并发迁移保护：防止多个进程同时执行迁移导致数据库状态不一致
2. 事务操作验证：明确标记那些无法在事务中执行的迁移操作

在 EF Core 9 之前，开发者可以自由地使用外部事务包裹迁移操作，这在需要确保多个上下文迁移原子性时特别有用。然而，这种模式在 9.0 版本中默认被禁止，因为某些迁移操作（如创建内存优化表）本质上无法参与事务。

影响范围

这一变更主要影响以下使用模式：

1. 多上下文原子迁移：使用单个事务确保多个 DbContext 的迁移要么全部成功，要么全部回滚
2. 测试环境迁移：在测试初始化时使用事务包裹迁移以便测试后回滚
3. 自定义迁移策略：显式控制迁移事务隔离级别或传播行为的场景

解决方案

根据微软团队的反馈，开发者可以采取以下应对策略：

1. 单上下文迁移：对于单个 DbContext 的迁移，直接调用 Migrate 方法而无需事务包裹
2. 多上下文迁移：EF Core 9.0.1 已修复多上下文迁移的事务支持问题
3. 避免事务包裹：移除显式的事务控制代码，依赖 EF Core 内置的事务管理

对于必须使用事务的场景，应确保迁移中不包含以下操作：

• 显式标记 suppressTransaction 的自定义 SQL
• 影响内存优化表的操作
• 其他无法在事务中执行的 DDL 命令

最佳实践

1. 简化迁移事务：尽可能让 EF Core 自行管理迁移事务
2. 检查迁移脚本：确认自动生成的迁移不包含非事务性操作
3. 版本适配：如需多上下文原子迁移，升级到 EF Core 9.0.1 或更高版本
4. 测试验证：在测试环境中充分验证迁移行为是否符合预期

总结

EF Core 9 对迁移事务行为的调整是为了提高系统健壮性和明确操作边界。虽然这带来了短期的兼容性挑战，但从长远看有助于构建更可靠的数据库迁移机制。开发者应理解这一变更的技术背景，并根据实际需求选择合适的迁移策略。