Entity Framework中标记为可为空的int字段仍报空值错误的原因

我有一个返回简单数据表的存储过程，使用Entity Framework通过以下代码调用：

var dbResult = await MyTypeResult.FromSqlRaw(
    "EXEC MyStoredProcedure @myVar",
    db_myVar
).ToListAsync();

其中MyTypeResult是DbSet<MyTypeResult>类型，该类定义如下：

public class MyTypeResult
{
    public int? Id { get; set; }
    // <more properties...>
}

运行时抛出错误：

读取MyTypeResult.Id属性的数据库值时出错。

预期类型为'System.Nullable`1[System.Int32]'但实际值为null。

我明确预期会返回空值，且已将Id属性标记为可为空，但仍出现该错误，请问原因是什么？

这个错误的核心是Entity Framework无法正确映射数据库返回的NULL值到可为空值类型，常见触发场景和解决方式如下：

• 数据库列元数据与实体属性不匹配：如果存储过程返回的Id列在元数据中被标记为非NULL类型（比如SQL Server的INT而非INT NULL），即便实际返回NULL，EF会依据列的非空定义尝试将NULL转换为非空int类型，进而抛出错误。需要检查存储过程返回结果集中Id列的定义是否允许NULL。

• EF实体配置未明确可选性：即使实体属性标记为int?，若未在DbContext的Fluent API配置中明确指定该属性为可选，EF可能默认将其视为必填项。可通过以下配置修正：

modelBuilder.Entity<MyTypeResult>()
    .Property(t => t.Id)
    .IsOptional();

• 存储过程返回的NULL值类型不兼容：部分数据库在特定场景下返回的NULL值带有特殊类型标记，EF无法自动识别。可在存储过程中显式转换NULL值为对应可为空类型，例如：

SELECT CAST(NULL AS INT) AS Id, -- 其他列...

• EF版本存在兼容性bug：旧版本的EF Core（如2.x及更早）在处理可为空值类型的NULL映射时存在缺陷，升级到5.x及以上的稳定版本可解决这类问题。

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