EF Core 6遇SqlNullValueException，如何定位触发字段？

问题描述 #

System.Data.SqlTypes.SqlNullValueException: Data is Null. This method or property cannot be called on Null values

在.NET 6.0环境下使用EF Core 6时触发上述错误，原因是EF Core尝试读取模型中标记为必填的属性，但数据库对应字段存在NULL值。

已尝试禁用nullable reference type，错误消失但无法排查具体问题；目视核对数据库与模型映射未发现不一致，需要定位引发异常的具体字段。

定位具体字段的方法 #

1. 开启EF Core日志查看执行SQL #

在Program.cs中配置EF Core日志，输出执行的SQL语句：

builder.Logging.AddFilter("Microsoft.EntityFrameworkCore.Database.Command", LogLevel.Information);

执行出错的查询后，把生成的SQL复制到数据库客户端（如SSMS）执行，查看返回结果里哪些字段是NULL，再对应到模型的必填属性。

2. 自定义拦截器捕获NULL字段 #

创建EF Core拦截器，在数据读取时检查NULL值并抛出明确异常：

public class NullValueInterceptor : DbCommandInterceptor
{
    public override DbDataReader ReaderExecuted(DbCommand command, CommandExecutedEventData eventData, DbDataReader result)
    {
        return new NullCheckingDataReader(result);
    }

    private class NullCheckingDataReader : DbDataReaderWrapper
    {
        public NullCheckingDataReader(DbDataReader innerReader) : base(innerReader) { }

        public override object GetValue(int ordinal)
        {
            if (IsDBNull(ordinal))
            {
                var columnName = GetName(ordinal);
                throw new InvalidOperationException($"字段 {columnName} 为NULL，但模型中标记为必填");
            }
            return base.GetValue(ordinal);
        }
    }
}

然后注册拦截器到DbContext：

builder.Services.AddDbContext<YourDbContext>(options =>
    options.UseSqlServer("你的连接字符串")
           .AddInterceptors(new NullValueInterceptor()));

运行程序后，异常会直接提示出具体的问题字段名。

3. 拆分查询逐步排查 #

把复杂查询拆成多个简单查询，逐步执行：先单独查询主实体，再依次添加关联导航属性，直到触发异常，以此缩小范围定位问题字段。

4. 调试时查看数据读取器 #

在调试模式下，异常触发时查看调用栈中的RelationalDataReader对象，展开后能看到当前读取的字段和对应值，直接找到NULL值对应的字段名。

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