Entity Framework查询报错：System.InvalidOperationException：可空对象必须有值

错误原因 #

触发System.InvalidOperationException: Nullable object must have a value的核心原因有两个：

1. 一对一关系配置错误：当前将Fixture的主键作为Result的外键，违背了常规一对一关系的设计逻辑，导致EF无法正确关联Fixture与Result，部分Fixture对应的Result会为null，直接访问i.Result.HomeScore就会触发空引用相关的nullable错误。
2. 导航属性未处理null场景：查询中直接访问多个导航属性（如HomeTeam、Result、SeasonCalendarDate）的子属性，未考虑这些导航属性可能为null的情况；同时若Match类的目标属性为非nullable值类型，null赋值操作会触发该错误。

具体修复步骤 #

1. 修正一对一关系配置 #

常规一对一关系中，应由依赖实体（Result）持有主实体（Fixture）的外键，而非反过来。

第一步：更新Result模型，添加外键字段

public class Result
{
    public long Id { get; set; }
    // 添加指向Fixture的外键字段
    public long FixtureId { get; set; }
    public League League { get; set; }
    public SeasonDivision Division { get; set; }
    public SeasonCalendarDate SeasonCalendarDate { get; set; }
    public Fixture Fixture { get; set; }
    // 其他省略属性
}

第二步：修改ApplicationDbContext中的关系配置

builder.Entity<Result>()
       .HasOne(r => r.Fixture)
       .WithOne(f => f.Result)
       .HasForeignKey<Result>(r => r.FixtureId); // 指定Result为依赖实体，持有外键

2. 优化查询逻辑，处理null场景 #

显式加载需要的导航属性，并针对可能为null的关联实体设置默认值：

var fixtures = await _context.Fixtures
                             // 显式包含所有需要的导航属性
                             .Include(f => f.HomeTeam)
                             .Include(f => f.AwayTeam)
                             .Include(f => f.SeasonCalendarDate)
                             .Include(f => f.Result)
                             .Include(f => f.League)
                             .Include(f => f.Division)
                             .Where(i => i.HomeTeam.Id == seasonteamid || 
                                         i.AwayTeam.Id == seasonteamid)
                             .Select(i => new Match
                                          {
                                              ReferenceId = i.Id,
                                              MatchType = MatchType.League,
                                              // 用null合并运算符处理导航属性为null的情况
                                              DateTime = i.SeasonCalendarDate?.Date ?? default,
                                              DateName = i.SeasonCalendarDate?.Name ?? string.Empty,
                                              MatchDetails = i.Division?.Name ?? string.Empty,
                                              HomeTeamName = i.HomeTeam?.TeamName ?? string.Empty,
                                              AwayTeamName = i.AwayTeam?.TeamName ?? string.Empty,
                                              HomeTeamId = i.HomeTeam?.Id ?? default,
                                              AwayTeamId = i.AwayTeam?.Id ?? default,
                                              HomeFrameScore = i.Result?.HomeScore ?? default,
                                              AwayFrameScore = i.Result?.AwayScore ?? default,
                                              MatchStatus = i.MatchStatus,
                                              LeagueId = i.League?.Id ?? default
                                         })
                             .ToListAsync();

3. 验证数据库数据 #

检查数据库中是否存在以下情况：

• Fixture对应的Result记录缺失
• HomeTeam/AwayTeam等关联实体未正确关联
• 关联实体的关键属性（如Id、Name）为null

这些数据缺失或异常也会导致查询时触发空引用错误。

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