EF Core 8实体未合并问题：升级后Components集合异常为空

问题根源 #

这是EF Core 8的变更跟踪实体复用机制导致的：

• 第一次查询Tasks时，通过Include(t => t.Document).ThenInclude(t => t.RouteStepValues)加载了Document实例，该实例会被EF上下文缓存。
• 后续查询Documents时，EF会优先返回缓存中的旧实例，而非重新加载带完整DocumentType.Components关联数据的新实例——哪怕你在第二次查询中添加了完整的Include链，缓存里的旧实例并没有加载这部分关联数据，因此访问时会出现空值。
• 移除第一次查询的Include后恢复正常，是因为此时上下文没有缓存Document实例，第二次查询会从数据库加载完整数据。

解决方案 #

1. 合并查询逻辑，避免重复加载同一实体 #

直接通过Task关联查询获取所需的完整数据，减少上下文缓存冲突：

var taskWithDocument = await _context.Tasks
    .Include(t => t.Document)
        .ThenInclude(d => d.RouteStepValues)
    .Include(t => t.Document.DocumentType)
        .ThenInclude(dt => dt.Components)
            .ThenInclude(c => c.ComponentPropertyDependencies)
                .ThenInclude(cpd => cpd.ElementProperty)
    .FirstOrDefaultAsync(t => t.Id == taskId);

if (taskWithDocument == null)
{
    // 处理Task不存在的场景
    return;
}

// 确定目标Document ID
var targetDocumentId = taskWithDocument.Document.ParentDocumentId ?? taskWithDocument.Document.Id;

// 如果目标是父文档，单独查询父文档的完整数据
var targetDocument = taskWithDocument.Document.Id == targetDocumentId 
    ? taskWithDocument.Document 
    : await _context.Documents
        .Include(d => d.RouteStepValues)
        .Include(d => d.DocumentType)
            .ThenInclude(dt => dt.Components)
                .ThenInclude(c => c.ComponentPropertyDependencies)
                    .ThenInclude(cpd => cpd.ElementProperty)
        .FirstOrDefaultAsync(d => d.Id == targetDocumentId);

// 后续正常获取数据
var currentRouteStep = targetDocument.RouteStepValues.FirstOrDefault(t => t.TaskId == taskId);
var currentRouteGroup = targetDocument.DocumentType.Components.FirstOrDefault(t => t.Id == componentId);

2. 强制忽略上下文缓存，重新加载实体 #

在第二次查询Documents时使用AsNoTracking()，让EF返回全新的实例，不复用缓存中的旧实例：

var document = await _context.Documents
    .AsNoTracking() // 关键：不使用上下文缓存
    .Include(d => d.RouteStepValues)
    .Include(t => t.DocumentType)
    .ThenInclude(t => t.Components)
    .ThenInclude(t => t.ComponentPropertyDependencies)
    .ThenInclude(t => t.ElementProperty)
    .FirstOrDefaultAsync(d => d.Id == documentId);

3. 清空上下文缓存（谨慎使用） #

如果必须保留两次独立查询，可以在第二次查询前清空上下文的变更跟踪缓存，但这会影响其他正在跟踪的实体，仅在特定场景使用：

// 清空所有跟踪的实体
_context.ChangeTracker.Clear();

var document = await _context.Documents
    .Include(d => d.RouteStepValues)
    .Include(t => t.DocumentType)
    .ThenInclude(t => t.Components)
    .ThenInclude(t => t.ComponentPropertyDependencies)
    .ThenInclude(t => t.ElementProperty)
    .FirstOrDefaultAsync(d => d.Id == documentId);

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