使用Linq操作EF Core一对多关系时出现System.NullReferenceException错误的原因？

核心原因 #

你遇到的空引用异常属于EF Core关联数据加载机制的典型问题，主要有以下几类触发场景：

• 没有预加载关联的导航属性：EF Core默认不会自动加载实体的关联导航属性，如果你查询Artists时没有显式指定加载Songs集合，Songs属性会保持默认值null，访问时直接抛出空引用。
• 查询到的Artist对象本身为null：如果你用FirstOrDefault等方法查询不存在的艺术家ID，返回值为null，直接访问null.Songs也会触发空引用。
• 实体类的导航属性配置错误：比如外键字段不匹配、导航属性没有初始化、一对多映射规则配置有误，都会导致关联数据无法正常绑定，导航属性为空。
• 延迟加载配置缺失：如果你的代码依赖延迟加载加载关联数据，但没有开启延迟加载代理、导航属性没有声明为virtual，也会导致导航属性为空。

解决步骤 #

1. 先确认实体类和映射配置正确 #

示例正确配置如下：

// 艺术家实体
public class Artist
{
    public int Id { get; set; }
    public string Name { get; set; }
    // 导航属性建议初始化，避免未加载时直接访问触发空引用
    public List<Song> Songs { get; set; } = new List<Song>();
}

// 歌曲实体
public class Song
{
    public int Id { get; set; }
    public string Title { get; set; }
    // 关联艺术家的外键，字段名要和Artist主键匹配，也可以用[ForeignKey]特性显式指定
    public int ArtistId { get; set; }
    public Artist Artist { get; set; }
}

如果用Fluent API配置映射，需要在DbContext的OnModelCreating方法中添加一对多配置：

modelBuilder.Entity<Song>()
    .HasOne(s => s.Artist)
    .WithMany(a => a.Songs)
    .HasForeignKey(s => s.ArtistId)
    // 可选配置外键约束行为
    .OnDelete(DeleteBehavior.Cascade);

2. 查询时显式预加载关联数据 #

这是最稳妥的方案，需要先引入命名空间using Microsoft.EntityFrameworkCore;，查询时加上Include方法指定要加载的关联属性：

// 示例查询指定ID的艺术家及关联的所有歌曲
var artist = await _dbContext.Artists
    .Include(a => a.Songs)
    .FirstOrDefaultAsync(a => a.Id == targetArtistId);

// 一定要先判断查询结果是否为空，再访问属性
if (artist == null)
{
    // 处理艺术家不存在的逻辑
    return;
}

var songs = artist.Songs; // 此时Songs已经被预加载，不会为空

3. （可选）使用延迟加载方案 #

如果你需要用延迟加载动态加载关联数据，需要做以下配置：

1. 安装NuGet包：Microsoft.EntityFrameworkCore.Proxies
2. 在DbContext的OnConfiguring方法中开启延迟加载代理：

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    optionsBuilder
        .UseLazyLoadingProxies() // 开启延迟加载代理
        .UseSqlServer("你的数据库连接字符串");
}

3. 把导航属性声明为virtual：

public virtual List<Song> Songs { get; set; } = new List<Song>();

排查小技巧 #

你可以先在报错行打断点，分别看artist对象和artist.Songs属性哪个为null，就能快速定位是查询返回了空的艺术家，还是关联属性没有加载。

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