EFCore复杂AsSplitQuery拆分查询偶发NullReferenceException如何排查

可能的异常诱因及排查方案 #

最高概率诱因：多线程共用非线程安全的DbContext #

DbContext从设计上就不支持多线程并行操作，你当前的并行任务代码如果共享了同一个DbContext实例，多个查询同时读写上下文内部状态、共享数据库连接，就会出现偶发的状态错乱。你使用的AsSplitQuery拆分查询需要维护多个子查询的结果拼接状态，多线程抢占资源时极易出现内部空引用，刚好匹配你在SplitQueryingEnumerable枚举器Dispose阶段抛出NRE的调用栈。

其他可能的诱因 #

• EF Core 5.x版本已知BUG：EF Core 5的拆分查询和过滤Include（你代码中ThenInclude(x => x.Dimensions.Where(vtd => vtd.PlanId == planId))这类写法）组合使用时，存在多个内存管理相关的已知问题，在枚举器释放阶段偶发空引用，这类问题大部分已在EF Core 6及更高版本中修复。
• 同步/异步调用混用：你的并行任务是异步实现，但查询使用的是同步ToList()方法，同步阻塞异步上下文可能导致DbContext相关资源被提前释放，枚举器Dispose时访问到已销毁的对象。
• 过滤Include边缘场景兼容问题：EF Core 5对过滤Include的支持本身不完善，当关联数据存在空关联的特殊场景下，拆分查询拼接结果时可能未做完整的空判断，偶发空引用。

排查修复建议 #

• 优先验证多线程问题：调整并行逻辑，每个异步任务内部单独创建DbContext实例，不共用全局上下文，测试后如果问题消失即可确认是线程安全问题。
• 替换查询逻辑测试：临时去掉AsSplitQuery改用默认单查询，或者把过滤Include的逻辑改为手动投影，排查是否是拆分查询+过滤Include的组合触发BUG。
• 调整调用方式：把同步的ToList()改为异步ToListAsync()，适配异步调用上下文避免阻塞异常。
• 版本升级：如果业务允许，直接升级EF Core到6.0以上版本，可解决大部分官方已知的查询相关BUG。

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