使用Entity Framework DbContext查询数据库时遭遇NullReferenceException

看起来你遇到的问题很典型——原生ADO.NET能正常读取数据，但换成EF的Database.SqlQuery<T>就触发了NullReferenceException，我帮你梳理几个最可能的原因和对应的解决办法：

1. 实体类与查询字段的映射不匹配 #

EF的SqlQuery<T>默认会按**属性名称（SQL Server环境下大小写不敏感）**和查询返回的字段名进行映射，如果两者不对应，实体的属性就会被设为默认值（比如null），后续访问这些null属性的子成员就会触发异常。

举个例子：如果你的实体类是这样的：

public class MyEntity
{
    public string MyField1 { get; set; }
    public string MyField2 { get; set; }
}

但你的查询是select field1, field2 from my_table，EF找不到MyField1对应的字段，就会把MyField1设为null，如果你后续访问MyField1.Length就会炸。

解决办法：

• 要么修改实体属性名和数据库字段名一致；
• 要么在SQL语句里给字段加别名，匹配实体属性：

  select field1 as MyField1, field2 as MyField2 from my_table
  

2. 实体类缺少公共无参构造函数 #

EF在通过SqlQuery<T>创建实体实例时，依赖公共的无参构造函数。如果你的实体类只有带参数的构造函数，EF无法实例化对象，可能返回null，进而触发异常。

解决办法：
给实体类添加一个公共无参构造函数：

public class MyEntity
{
    // 无参构造
    public MyEntity() {}

    // 你的带参构造
    public MyEntity(string field1, string field2)
    {
        MyField1 = field1;
        MyField2 = field2;
    }

    public string MyField1 { get; set; }
    public string MyField2 { get; set; }
}

3. 访问了未被填充的导航属性 #

SqlQuery<T>只会填充实体的标量属性（直接对应数据库列的属性），不会自动加载导航属性（比如关联的其他实体）。如果你的实体类有导航属性，且你在代码中访问了它，就会因为导航属性为null而触发异常。

比如你的实体类是：

public class MyEntity
{
    public string Field1 { get; set; }
    public RelatedEntity Related { get; set; } // 导航属性
}

用SqlQuery<MyEntity>查询后，Related属性是null，如果你执行Related.SomeProperty就会触发NullReferenceException。

解决办法：

• 如果需要导航属性，改用EF的LINQ查询并使用Include方法加载关联数据；
• 如果你不需要导航属性，要么从实体类中移除它，要么确保代码中不会访问它。

4. 实体属性类型与数据库字段不匹配 #

如果数据库字段的类型和实体属性类型不兼容（比如数据库是varchar但实体是int），EF无法完成映射，会把属性设为null，后续访问就会触发异常。

解决办法：

• 确保实体属性类型和数据库字段类型匹配，比如数据库字段是可空的int，实体用int?；
• 如果类型确实需要转换，可以在SQL语句中处理，比如select CAST(field1 as int) as Field1 from my_table。

调试小技巧 #

你可以在代码中加个断点，查看返回的实体实例状态：

var ctx = new BackupDbContext();
var entities = ctx.Database.SqlQuery<MyEntity>("select field1, field2 from my_table").ToList();
// 查看entities是否为空，或者某个属性是否为null
if (!entities.Any())
{
    Console.WriteLine("没有查询到数据");
}
else
{
    var firstEntity = entities.First();
    Console.WriteLine($"Field1: {firstEntity.Field1}, Field2: {firstEntity.Field2}");
}

这样能快速定位是实体本身为null，还是某个属性为null导致的异常。

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