EFCorePowerTools 项目升级至 .NET Core 8 后存储过程调用问题解析

问题背景

在将项目从 .NET Core 6 升级到 .NET Core 8 并更新 EF Core 相关包后，开发人员遇到了调用 SQL Server 存储过程时出现的运行时错误："Cannot create a DbSet for 'xxxx' because this type is not included in the model for the context"。

问题分析

这个问题的本质在于 EF Core 8 对存储过程返回类型的处理方式发生了变化。在 EF Core 8 中，所有用于存储过程返回结果的实体类型都需要在 DbContext 中显式配置，而 EF Core 6 及之前版本对此要求较为宽松。

解决方案

临时解决方案

可以通过在 DbContext 的 OnModelCreating 方法中为存储过程返回类型添加无键配置：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder);
    
    modelBuilder.Entity<resultType>().HasNoKey();
}

这种方法适用于需要快速解决问题的场景，可以通过创建 DbContext 的部分类来添加这些配置，而不会影响工具生成的代码。

根本解决方案

对于使用 EFCorePowerTools 生成代码的项目，需要注意：

1. 确保使用的是最新版本的 EFCorePowerTools（2.6.287 或更高）
2. 确认 EF Core 8.0.x 的最新版本已修复了相关生成问题
3. 重新生成存储过程映射代码

技术原理

EF Core 8 引入了更严格的模型验证机制，要求所有通过 DbSet 访问的实体类型都必须在模型中有明确定义。对于存储过程返回的结果集，由于它们通常不包含主键，需要使用 HasNoKey() 方法显式声明。

最佳实践

1. 版本一致性：确保 EFCorePowerTools、EF Core 和 .NET Core 版本相互兼容
2. 代码生成：充分利用 EFCorePowerTools 的代码生成功能，避免手动维护存储过程映射
3. 显式配置：对于自定义的存储过程调用，始终为返回类型添加适当的模型配置
4. 升级验证：在升级 EF Core 主要版本时，全面测试存储过程调用功能

总结

从 EF Core 6 升级到 8 时，存储过程调用需要特别注意返回类型的模型配置问题。通过理解 EF Core 8 的更严格模型验证机制，并采取适当的配置措施，可以确保存储过程功能在升级后继续正常工作。对于使用代码生成工具的项目，保持工具链的最新状态是避免此类问题的关键。