解决！EF Core 9.0 ExecuteUpdate 方法迁移中的 3 大陷阱与解决方案
项目地址: https://gitcode.com/GitHub_Trending/ef/efcore 你是否在将项目迁移到 EF Core 9.0 后，发现原本正常运行的 ExecuteUpdate 方法突然抛出异常？或者执行后没有更新预期的数据？本文将深入分析 EF Core 9.0 中 ExecuteUpdate 方法迁移时可能遇到的兼容性问题，并提供具体的代码修复方案，帮助你快速解决这些棘手问题。
一、方法调用方式变更导致的编译错误
在 EF Core 9.0 中，ExecuteUpdate 方法的调用方式有了细微但重要的调整。如果你在迁移后遇到编译错误，很可能是因为没有正确适配新的方法签名。
问题示例
// EF Core 9.0 之前的写法
context.Set<Owner>().ExecuteUpdate(s => s.SetProperty(o => o.Title, "NewTitle"));
// EF Core 9.0 可能需要的调整
var result = context.Set<Owner>().ExecuteUpdate(s => s.SetProperty(o => o.Title, "NewTitle"));
Assert.Equal(1, result); // 新增返回值检查
解决方案
在 EF Core 9.0 中，ExecuteUpdate 方法返回一个 int 类型的值，表示受影响的行数。因此，你需要接收这个返回值，即使你不打算使用它。
// 正确的写法
var affectedRows = context.Set<Owner>().ExecuteUpdate(s => s.SetProperty(o => o.Title, "NewTitle"));
// 可以添加断言验证更新是否成功
Assert.Equal(expectedAffectedRows, affectedRows);
相关测试代码可以参考 test/EFCore.Specification.Tests/BulkUpdates/NonSharedModelBulkUpdatesTestBase.cs 中的实现。
二、异步方法的异常处理机制变化
EF Core 9.0 对异步方法的异常处理进行了优化，但这也可能导致迁移后的代码行为发生变化。特别是当数据库提供程序不支持 ExecuteUpdateAsync 方法时，异常的抛出方式有所不同。
问题分析
在 EF Core 9.0 中，如果使用了不支持的异步方法，会抛出 InvalidOperationException 异常，异常消息会明确指出不支持的方法。
// 这段代码在不支持异步更新的提供程序上会抛出异常
try
{
await context.Set<TestEntity>().ExecuteUpdateAsync(s => s.SetProperty(e => e.Id, 1));
}
catch (InvalidOperationException ex)
{
// 异常消息会包含 "ExecuteUpdate" 和 "ExecuteUpdateAsync"
Console.WriteLine(ex.Message);
}
解决方案
确保你的数据库提供程序支持异步操作，或者在使用异步方法时添加适当的异常处理。
try
{
var affectedRows = await context.Set<TestEntity>().ExecuteUpdateAsync(s => s.SetProperty(e => e.Id, 1));
// 处理成功情况
}
catch (InvalidOperationException ex) when (ex.Message.Contains("ExecuteUpdateAsync"))
{
// 处理不支持异步操作的情况，例如回退到同步方法
var affectedRows = context.Set<TestEntity>().ExecuteUpdate(s => s.SetProperty(e => e.Id, 1));
}
相关的异常处理测试可以参考 test/EFCore.Tests/Query/QueryProviderTest.cs。
三、复杂查询中的表别名冲突
EF Core 9.0 改进了查询生成器，特别是在处理复杂查询时的表别名生成。这可能导致某些在旧版本中可以正常工作的复杂查询在新版本中出现问题。
问题示例
当在 Update 操作中使用子查询时，可能会遇到表别名冲突的问题：
// 可能导致别名冲突的查询
var query = context.Orders.Where(o => o.Id == 1)
.Select(o => new { Order = o, Total = o.OrderProducts.Sum(op => op.Amount) });
await query.ExecuteUpdateAsync(s => s.SetProperty(x => x.Order.Total, x => x.Total));
解决方案
尽量简化查询，避免在 Update 操作中使用过于复杂的子查询。如果必须使用复杂查询，可以尝试显式指定别名或拆分查询。
// 优化后的查询
var orderId = 1;
var total = await context.OrderProducts
.Where(op => op.OrderId == orderId)
.SumAsync(op => op.Amount);
await context.Orders
.Where(o => o.Id == orderId)
.ExecuteUpdateAsync(s => s.SetProperty(o => o.Total, total));
更多关于复杂查询更新的示例可以参考 test/EFCore.Specification.Tests/BulkUpdates/NonSharedModelBulkUpdatesTestBase.cs。
三、与 Owned Entity 的交互变化
EF Core 9.0 对 Owned Entity 的处理进行了优化，这可能会影响涉及 Owned Entity 的 ExecuteUpdate 操作。
问题分析
当更新包含 Owned Entity 的实体时，EF Core 9.0 可能会生成不同的 SQL 语句，特别是在表共享（Table Sharing）场景下。
// 涉及 Owned Entity 的更新
await context.Set<Owner>()
.ExecuteUpdateAsync(s => s
.SetProperty(o => o.Title, "NewTitle")
.SetProperty(o => o.OwnedReference.Number, 42));
解决方案
确保在更新包含 Owned Entity 的实体时，显式指定所有需要更新的属性，并且在模型配置中正确设置了 Owned Entity 的关系。
// 显式更新所有必要的属性
await context.Set<Owner>()
.ExecuteUpdateAsync(s => s
.SetProperty(o => o.Title, "NewTitle")
.SetProperty(o => o.OwnedReference.Number, 42));
相关的测试案例可以参考 test/EFCore.Specification.Tests/BulkUpdates/NonSharedModelBulkUpdatesTestBase.cs 中的实现。
总结与迁移建议
迁移到 EF Core 9.0 时，关于 ExecuteUpdate 方法的主要注意事项包括：
- 处理返回值：确保接收并处理 ExecuteUpdate 方法返回的受影响行数。
- 异步方法兼容性：检查数据库提供程序对异步方法的支持情况。
- 复杂查询优化：避免在 Update 操作中使用过于复杂的子查询，必要时进行拆分。
- Owned Entity 更新：注意 Owned Entity 在更新操作中的处理方式变化。
为了确保平滑迁移，建议你：
- 全面测试所有使用 ExecuteUpdate 和 ExecuteDelete 的代码路径
- 关注数据库提供程序的更新，确保使用与 EF Core 9.0 兼容的版本
- 考虑使用单元测试验证更新操作的行为，可参考 test/EFCore.Tests/Query/QueryProviderTest.cs 中的测试策略
通过以上措施，你应该能够顺利解决 EF Core 9.0 迁移中与 ExecuteUpdate 方法相关的大部分问题。如果遇到其他问题，建议查阅官方文档或提交 issue 寻求帮助。
希望本文能帮助你顺利完成 EF Core 9.0 的迁移工作。如果你觉得本文有用，请点赞、收藏并关注，以便获取更多关于 EF Core 的实用技巧和最佳实践。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
