EntityFramework Core 8 中自定义提供程序升级指南：处理 UnexpectedTrailingResultSetWhenSaving 异常

问题背景

在将自定义的 EntityFramework Core 提供程序升级到 EF Core 8 版本时，开发人员可能会遇到一个特定异常：UnexpectedTrailingResultSetWhenSaving。这个异常通常在执行插入操作后尝试获取生成的主键值时出现，表现为系统认为返回的结果集是意外的。

异常现象分析

当使用自定义 EF Core 提供程序执行插入操作时，典型的 SQL 语句可能如下：

INSERT INTO "Products" ("Discontinued", "ProductName", "SupplierID", "UnitPrice", "UnitsInStock")
VALUES (@p0, @p1, @p2, @p3, @p4);
SELECT SCOPE_IDENTITY() as ProductID FROM DUAL;

在 EF Core 8 中，系统会对这种返回结果集的行为产生警告，并可能抛出异常，提示"在读取 SaveChanges 操作结果时发现意外的尾随结果集"。

根本原因

EF Core 8 引入了更严格的结果集验证机制。当执行插入、更新等修改操作时，系统会检查返回的结果集是否符合预期。对于自定义提供程序，需要明确告知 EF Core 哪些结果集是预期的，哪些不是。

解决方案

1. 修改 UpdateSqlGenerator 实现

核心解决方案在于正确实现 IUpdateSqlGenerator 接口的 AppendInsertOperation 方法。该方法需要返回适当的 ResultSetMapping 枚举值：

• ResultSetMapping.LastInResultSet：表示这是结果集中的最后一个
• ResultSetMapping.NotLastInResultSet：表示这不是结果集中的最后一个（用于批量操作）

对于大多数单条插入操作，应该返回 LastInResultSet，明确告知 EF Core 这个结果集是预期的。

2. 临时解决方案（不推荐）

虽然可以通过配置警告来忽略此异常，但这只是临时解决方案：

options.ConfigureWarnings(w => 
    w.Ignore(RelationalEventId.UnexpectedTrailingResultSetWhenSaving));

这种方法不推荐在生产环境中使用，因为它掩盖了潜在的问题。

最佳实践建议

1. 全面审查自定义提供程序：升级到 EF Core 8 时，应全面审查所有自定义 SQL 生成逻辑

2. 明确结果集预期：对于每个修改操作，明确指定预期的结果集数量和类型

3. 利用新版本特性：EF Core 8 提供了更精细的控制机制，应充分利用这些特性来构建更健壮的提供程序

4. 测试覆盖：增加对结果集处理的测试用例，确保在各种场景下都能正确处理

总结

EF Core 8 对结果集处理引入了更严格的验证机制，这要求自定义提供程序的开发者更加明确地声明操作的结果集预期。通过正确实现 IUpdateSqlGenerator 接口并返回适当的 ResultSetMapping 值，可以确保提供程序与 EF Core 8 的兼容性，同时保持原有的功能不变。这一改变虽然增加了初期升级的工作量，但有助于构建更可靠、更易维护的数据访问层。