使用.ProjectTo映射出现Value cannot be null异常如何溯源排查

数据老陈

2026-8-28

根本原因

这个异常和你初步怀疑的关联加载逻辑有关系，但核心问题是你把ProjectTo用错了位置，直接看异常栈就能实锤：栈里调用的是System.Linq.Enumerable.Select，说明映射是在内存里执行的，不是在EF数据库查询阶段执行的。
你现在的代码逻辑是：

先查Flow，只Include了Disciplines导航，查询执行完Discipline实体已经加载到内存，这时候Discipline下面的DisciplineHours集合导航属性根本没加载，默认值是null
你拿内存里的flow.Disciplines调用AsQueryable()再用ProjectTo，这时候的ProjectTo没法让EF补查关联数据，只能遍历内存里的Discipline实体做映射，映射DisciplineHours属性的时候会对这个属性调用LINQ的Select方法做子对象投影，结果传进去的source是null，直接触发ArgumentNullException，和日志里的报错完全吻合。

另外你写的DisciplineHour映射规则就算把DisciplineHours加载了也会出问题：映射时访问了sh.Discipline.FullName、sh.ClassActivityType.ShortName这俩嵌套导航属性，要是这俩关联数据没加载，要么抛空引用，要么触发EF的延迟查询产生N+1问题。

追溯定位步骤

先看异常栈特征：只要栈里是System.Linq.Enumerable开头的方法调用，就说明异常发生在内存对象的LINQ操作阶段，直接排除EF查询翻译、SQL执行层面的问题，缩小范围到内存映射环节。
核对ProjectTo的执行场景：ProjectTo只有对接EF原生的、还没执行的数据库查询IQueryable时，才会自动解析投影需要的字段、关联属性，自动生成对应SQL，不需要手动写Include/ThenInclude；如果是对已经加载到内存的集合调用AsQueryable()再用ProjectTo，本质就是内存对象映射，AutoMapper不会补查任何关联数据，只会读对象当前已有的属性值。
核对导航属性加载状态：你查询Flow时只加载了Disciplines集合，Discipline下的DisciplineHours、Department、Period，DisciplineHour下的ClassActivityType这些关联全没加载，其中集合类型的导航属性没初始化、没加载时默认值是null，传入LINQ的Select、ToList等方法时就会触发Parameter 'source'空异常。

修复方案

推荐方案（符合ProjectTo的设计用法，性能最好，不用写一堆Include）：不要先把Flow整行查出来再做内存投影，直接在EF查询层调用ProjectTo，让AutoMapper帮你生成查询逻辑：

public Task<Response> Handle(GetDisciplinesByFlowIdQuery request, CancellationToken cancellationToken)
{
    // 保留原来的Flow存在校验逻辑
    var flowIsExisted = _context.Flows.Any(x => x.Id == request.FlowId);
    if (!flowIsExisted)
    {
        throw new NotFoundException(nameof(Flow), request.FlowId);
    }

    var result = _context.Disciplines
        .Where(d => d.Flows.Any(f => f.Id == request.FlowId))
        .ProjectTo<DisciplineDto>(_mapper.ConfigurationProvider)
        .ToList();

    return Task.FromResult(result);
}

临时修复方案（不推荐，维护成本高、性能差）：如果你一定要先查Flow再做内存映射，要做两个改动：
1. 给所有实体的集合导航属性默认初始化空集合，避免null传入LINQ方法，比如public List<DisciplineHour> DisciplineHours { get; set; } = new();，所有List类型的导航属性都按这个方式处理
2. 查询时把所有映射需要的关联数据全用Include/ThenInclude加载全：

var flow = _context.Flows
    .Include(f => f.Disciplines).ThenInclude(d => d.DisciplineHours).ThenInclude(dh => dh.ClassActivityType)
    .Include(f => f.Disciplines).ThenInclude(d => d.Department)
    .Include(f => f.Disciplines).ThenInclude(d => d.Period)
    .SingleOrDefault(x => x.Id == request.FlowId);

这种写法只要后续Dto加了新的映射字段，就要同步加Include，漏一个就出问题，非必要不要用。

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