ASP.NET Core 6+EF Core 6调用存储过程FromSqlInterpolated报错求助

1. 核对实体类与存储过程返回字段的映射一致性 #

EF Core对存储过程结果集的映射要求严格，必须保证：

• 存储过程返回的每一列名称（含大小写）与实体类属性完全匹配，不一致时可在存储过程中用AS重命名列，或在实体属性上添加[Column("列名")]特性指定映射；
• 列的数据类型、可空性与实体属性完全对应，比如存储过程返回decimal(18,2)，实体属性不能设为float；存储过程返回非空列，实体属性不能标记为可空。

2. 验证存储过程的实际返回结果 #

在SSMS中手动执行EXEC 存储过程名 @参数值，确认：

• 确实返回且仅返回1条记录；
• 结果集的列结构和预期一致，避免因参数逻辑问题导致返回0条或多条记录，触发EF Core映射异常。

3. 调整EF Core查询的跟踪模式 #

尝试在FromSqlInterpolated后添加AsNoTracking()，禁用实体跟踪：

await dbContext.YourEntities
    .FromSqlInterpolated($"EXEC YourProc @Id={paramValue}")
    .AsNoTracking()
    .FirstOrDefaultAsync();

跟踪查询对存储过程结果集的元数据校验更严格，禁用跟踪可规避部分映射冲突问题。

4. 排除存储过程的输出参数/返回值干扰 #

如果存储过程定义了输出参数或返回值（如RETURN @Result或OUTPUT @OutParam），FromSqlInterpolated仅能处理结果集，多余的输出会导致EF Core解析失败。

• 若无需输出参数，直接修改存储过程移除相关定义；
• 若必须保留，改用SqlCommand手动执行并读取结果：

using var cmd = dbContext.Database.GetDbConnection().CreateCommand();
cmd.CommandText = "YourProc";
cmd.CommandType = System.Data.CommandType.StoredProcedure;
cmd.Parameters.Add(new SqlParameter("@Id", paramValue));

await dbContext.Database.OpenConnectionAsync();
using var reader = await cmd.ExecuteReaderAsync();
var result = await dbContext.YourEntities.FromSqlRaw(reader).FirstOrDefaultAsync();

5. 配置无键实体（若适用） #

如果目标实体没有定义主键，需在DbContext的OnModelCreating中显式配置无键：

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

EF Core 6对无键实体的存储过程映射需要明确配置，否则会触发映射异常。

6. 升级EF Core补丁版本 #

EF Core 6存在部分存储过程相关的已知bug，比如结果集元数据读取失败问题，升级到EF Core 6的最新补丁版本可解决这类官方已修复的问题。

内容的提问来源于stack exchange，提问作者kintela