EF Core 9 迁移事务行为变更解析与解决方案

问题背景

在 EF Core 9 中，团队对迁移过程中的事务处理机制进行了重要调整，这导致了一些原本在 EF Core 8 中能够正常工作的代码在升级后出现了异常。具体表现为当开发者尝试在用户事务中执行数据库迁移时，系统会抛出"User transaction is not supported with a TransactionSuppressed migrations or a retrying execution strategy"异常。

技术细节分析

EF Core 9 引入了几项与迁移相关的重要变更：

1. 并发迁移保护机制：为了防止多个应用实例同时执行迁移导致冲突，EF Core 9 增加了迁移锁机制。

2. 事务抑制操作检测：现在能够自动检测并警告那些无法在事务中执行的迁移操作。

3. 执行策略优化：对重试执行策略进行了调整，使其与事务的交互更加明确。

这些变更的核心目的是提高迁移过程的可靠性和安全性，但同时也改变了事务处理的行为规范。

典型场景与解决方案

多DbContext迁移场景

在 EF Core 8 中，开发者通常会使用事务来确保多个 DbContext 的迁移要么全部成功，要么全部回滚。例如：

using (var tran = conn.BeginTransaction()) 
{
    using (var aContext = new AContext()) 
    {
        aContext.Database.SetDbConnection(conn);
        using var aCtxTran = await aContext.Database.UseTransactionAsync(tran);
        await aContext.Database.MigrateAsync();
    }

    using (var bContext = new BContext()) 
    {
        bContext.Database.SetDbConnection(conn);
        using var bCtxTran = await bContext.Database.UseTransactionAsync(tran);
        await bContext.Database.MigrateAsync();
    }

    await tran.CommitAsync();
}

在 EF Core 9 中，这种行为会触发异常。解决方案是：

1. 升级到 EF Core 9.0.1：该版本已修复多DbContext迁移场景的问题。

2. 简化事务处理：对于单个DbContext迁移，EF Core 9 已经内置了足够的事务保障，不再需要手动包装事务。

测试环境中的迁移

测试代码中常见的迁移模式也需要调整：

// 旧方式（EF Core 8）
await using var transaction = await dbContext.Database.BeginTransactionAsync(cancellationToken);
await dbContext.Database.MigrateAsync(cancellationToken);
await transaction.CommitAsync(cancellationToken);

// 新方式（EF Core 9）
await dbContext.Database.MigrateAsync(cancellationToken);

最佳实践建议

1. 评估迁移操作：检查迁移中是否包含无法在事务中执行的操作（如某些特定的SQL命令或内存优化表操作）。

2. 简化事务处理：在EF Core 9中，除非有特殊需求，否则应避免手动管理迁移事务。

3. 并发控制：对于测试环境中的并发迁移，考虑使用同步锁而不是事务来控制执行顺序。

4. 版本适配：如果必须使用外部事务，确保使用EF Core 9.0.1或更高版本。

总结

EF Core 9对迁移事务处理的改进虽然带来了一些兼容性挑战，但这些变更从根本上提高了系统的健壮性。开发者应理解这些变更背后的设计理念，并相应调整自己的代码实践。对于大多数场景，简化事务处理代码即可；对于特殊需求，可以通过升级到最新补丁版本来获得更好的支持。