ASP.NET Core 5 JSON序列化检测到对象循环 如何不改动输出结构解决

方法1：使用System.Text.Json内置的忽略循环引用配置（适用于.NET 6及以上版本） #

你只需要把原来的ReferenceHandler.Preserve替换为ReferenceHandler.IgnoreCycles即可，该配置会在序列化时直接将造成循环引用的属性设为null，不会额外添加$id、$ref等特殊标记，完全不会改变原有JSON结构：

services.AddControllers().AddJsonOptions(options =>
{
    options.JsonSerializerOptions.Converters.Add(new JsonStringEnumConverter());
    // 替换原有Preserve配置为忽略循环引用
    options.JsonSerializerOptions.ReferenceHandler = ReferenceHandler.IgnoreCycles;
});

如果你的项目仍然运行在.NET 5版本，原生System.Text.Json不支持IgnoreCycles配置，可以选择升级到.NET 6+，或者改用Newtonsoft.Json实现需求。

方法2：使用Newtonsoft.Json处理（兼容所有.NET Core版本） #

1. 首先安装NuGet包 Microsoft.AspNetCore.Mvc.NewtonsoftJson
2. 替换原有JSON配置为以下内容：

services.AddControllers()
    .AddNewtonsoftJson(options =>
    {
        options.SerializerSettings.Converters.Add(new StringEnumConverter());
        // 忽略循环引用，不会改变JSON结构
        options.SerializerSettings.ReferenceLoopHandling = ReferenceLoopHandling.Ignore;
    });

额外优化建议 #

• 可以在实体类的反向导航属性上添加[JsonIgnore]特性，从序列化层面直接排除不需要返回的导航属性，从根源避免循环引用问题
• 更推荐新增专门的DTO（数据传输对象）层做返回值映射，只保留前端需要的字段，不要直接返回EF Core的实体类，既可以避免循环引用，也能防止敏感字段泄露。

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