EF6在MVC正常WebAPI预加载出现JSON循环引用问题

你遇到的循环引用报错、返回冗余嵌套数据，本质是三个逻辑点共同导致的：

• 循环引用报错来自EF实体的双向导航属性设计：Beer实体持有Brand导航属性，Brand实体又持有Beers集合导航属性，EF加载关联数据后会自动补全双向引用，System.Text.Json默认序列化时会顺着引用无限递归，直到触发最大深度32的限制抛出异常。
• 返回冗余嵌套数据的核心原因是DTO定义和AutoMapper配置错误，和EF查询、JSON序列化配置无关。你当前的BeerReadDTO直接引用了数据库实体类Brand，AutoMapper默认同名映射时会把整个Brand对象（包含其下的Beers集合）全部映射到DTO中；你配置的ReferenceHandler.IgnoreCycles只是把循环引用的位置置为null，不会自动帮你做结构扁平化。
• 你观察到SQL只查询了Beer和Brand的基础字段、结果里却出现完整Beers集合，是EF的默认行为：开启变更跟踪的情况下，EF会在内存中自动做关系修复（Relationship Fixup），把同上下文内查询到的同品牌Beer自动填充到Brand的Beers导航属性下，不需要额外执行SQL查询。
• 普通MVC项目中相同写法无问题，是因为旧版MVC默认使用Newtonsoft.Json，默认循环引用处理逻辑和System.Text.Json不同，且多数MVC场景下不会直接序列化EF实体，而是使用结构明确的ViewModel。

1. 修正DTO定义，禁止在DTO中引用数据库实体 #

你期望的返回结构中brand字段是品牌名称字符串，不是完整的Brand对象，首先修改BeerReadDTO定义：

public class BeerReadDTO
{
    public int Id { get; set; }
    public string Name { get; set; } = null!;
    // 定义为字符串类型，直接对应要返回的品牌名称
    public string Brand { get; set; } = null!;
}

2. 调整AutoMapper映射规则 #

默认的同名映射无法自动关联Brand.Name到DTO的Brand字段，需要手动配置映射逻辑：

public class AutoMapperConf : Profile
{
    public AutoMapperConf()
    {
        CreateMap<Beer, BeerReadDTO>()
            // 手动指定DTO的Brand字段取值来源为关联Brand实体的Name属性
            .ForMember(dest => dest.Brand, opt => opt.MapFrom(src => src.Brand.Name));
    }
}

3. 清理冗余配置（可选但推荐） #

完成以上两步后，映射生成的DTO是完全扁平化的结构，不存在任何循环引用，之前添加的ReferenceHandler.IgnoreCyclesJSON配置可以删除，避免其他接口出现意外的序列化截断问题。如果需要保留全局配置防止其他接口误序列化EF实体，也可以保留，不影响当前接口返回结果。

• 永远不要直接将EF数据库实体返回给前端，也不要在DTO中引用任何数据库实体类，所有返回字段必须在DTO中明确定义，从根源避免循环引用、敏感字段泄漏、冗余字段返回问题。
• 如果后续接口需要返回品牌详情，单独定义简化的品牌DTO，只包含需要的Id、Name等字段，不要携带Beers这类会产生循环的导航属性。
• 你的Repository层SavaChangesAsync方法存在拼写错误，正确拼写应为SaveChangesAsync，建议修正避免后续调用出错。

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