为何EF Core中.Include()内的.Where()无法实现参与者筛选？

需要获取包含当前用户作为参与者的聊天记录，且仅加载活跃的参与者。执行以下查询后，“筛选包含当前用户的聊天”条件正常工作，但参与者的筛选（仅加载活跃用户）未生效，所有用户都被包含进来。

原查询代码 #

var query = _db.Chats
            .Include(c => c.Participants.Where(cu=>cu.IsActive))
            .Include(c=>c.LastMessage)
            .ThenInclude(m => m.Sender)
            .ThenInclude(cu => cu.User)
            .Where(c =>
                c.Participants.Any(cu => cu.UserId == _currentUser.MessengerUserId))
            .OrderByDescending(c => c.LastMessage != null ? c.LastMessage.Timestamp : c.Created)
            .AsNoTracking();

问题原因及解决方案 #

原因分析 #

EF Core中，Include内的过滤条件（Filtered Include）仅在EF Core 5.0及以上版本才支持。如果项目使用更早版本，这个过滤逻辑不会被执行，会加载所有参与者。即使版本符合要求，也可能因查询上下文或EF查询解析问题导致过滤未生效。

另外，Filtered Include仅影响关联数据的加载，不会改变主查询结果集，但这里需要加载聊天时仅包含活跃参与者，需确保过滤逻辑被正确应用。

解决方案 #

方案1：确认并升级EF Core版本

确保项目使用EF Core 5.0或更高版本。版本过低时，升级后Include(c => c.Participants.Where(cu=>cu.IsActive))的过滤逻辑会自动生效。

方案2：使用投影（Select）明确控制返回数据

如果不想依赖Filtered Include，或版本无法升级，可通过投影手动筛选活跃参与者，这种方式更直观可控：

var query = _db.Chats
    .Where(c => c.Participants.Any(cu => cu.UserId == _currentUser.MessengerUserId))
    .Select(c => new 
    {
        ChatId = c.Id,
        Created = c.Created,
        // 筛选活跃参与者
        ActiveParticipants = c.Participants.Where(cu => cu.IsActive).ToList(),
        // 处理最后一条消息及关联发送者信息
        LastMessage = c.LastMessage != null ? new 
        {
            MessageId = c.LastMessage.Id,
            Content = c.LastMessage.Content,
            Timestamp = c.LastMessage.Timestamp,
            Sender = c.LastMessage.Sender,
            SenderUser = c.LastMessage.Sender.User
        } : null
    })
    .OrderByDescending(x => x.LastMessage != null ? x.LastMessage.Timestamp : x.Created)
    .AsNoTracking();

若需返回实体类型而非匿名对象，可创建DTO类承载数据。

方案3：检查生成的SQL语句

查看生成的PostgreSQL脚本，确认是否包含对Participants.IsActive的过滤条件。如果没有，说明EF未正确解析Include内的过滤逻辑，此时优先尝试方案2的投影方式，或检查EF配置是否存在问题。

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