LINQ查询含Where条件的Include对象时出现自引用循环问题排查

你遇到的问题确实是因为查询写法有误，咱们一步步拆解来看：

首先，你原本的查询：

return await context.Members.Include(c => c.VitalSigns.Where(t => t.Event == "post surgery")).ToListAsync();

这个写法有两个核心问题：

1. 没有正确筛选目标Member #

Include方法的作用是加载关联实体，而不是筛选主实体。你在Include里加Where，只会让EF Core加载所有Member，只是每个Member的VitalSigns集合只包含符合Event == "post surgery"的项，但那些完全没有该类型VitalSign的Member也会被返回，这显然不是你想要的结果。

2. 自引用循环的根源 #

自引用循环是因为你的Member和VitalSign是双向导航关联（Member有VitalSigns集合，VitalSign又关联回Member），当序列化这些实体对象时，序列化器会无限遍历这个引用链（Member → VitalSign → Member → VitalSign...），从而抛出循环引用的错误。这和是否存在不符合条件的VitalSign无关，只要双向导航存在，序列化就容易触发这个问题。

正确的写法应该是这样的 #

如果你想要只返回拥有至少一个"post surgery"类型VitalSign的Member，并且只加载这些符合条件的VitalSigns，可以用以下两种方式：

方式一：EF Core 5+ 支持的过滤Include

return await context.Members
    // 先筛选出有目标VitalSign的Member
    .Where(m => m.VitalSigns.Any(vs => vs.Event == "post surgery"))
    // 加载关联的VitalSigns，并过滤出符合条件的项
    .Include(m => m.VitalSigns.Where(vs => vs.Event == "post surgery"))
    .ToListAsync();

方式二：用投影避免序列化问题（更推荐）

投影可以只返回你需要的字段，完全避开双向导航的序列化循环，同时逻辑更清晰：

return await context.Members
    .Where(m => m.VitalSigns.Any(vs => vs.Event == "post surgery"))
    .Select(m => new Member
    {
        Id = m.Id,
        FullName = m.FullName,
        VitalSigns = m.VitalSigns.Where(vs => vs.Event == "post surgery").ToList()
    })
    .ToListAsync();

额外解决自引用循环的小技巧 #

如果你还是想用实体序列化而不是投影，可以在DbContext的配置里添加循环引用忽略：

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    optionsBuilder.UseSqlServer("你的连接字符串")
        .UseJsonOptions(options => 
            options.JsonSerializerOptions.ReferenceHandler = ReferenceHandler.IgnoreCycles);
}

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