C# 如何处理JSON中的循环引用 - JsonSerializerSettings配置

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

C# 如何处理JSON中的循环引用 - JsonSerializerSettings配置

2025-12-05

浏览次数：次

返回列表

System.Text.Json 默认不支持循环引用，会抛出异常以避免栈溢出和内存问题；推荐通过断开引用、[JsonIgnore] 特性或自定义 Converter 显式处理。

c# 如何处理json中的循环引用 - jsonserializersettings配置

在 C# 中使用 System.Text.Json（.NET Core 3.0+ 默认 JSON 库）时，它默认不支持循环引用检测与处理，也不会像旧版 Newtonsoft.Json 那样通过 JsonSerializerSettings.ReferenceLoopHandling 自动跳过或序列化引用。如果你遇到“A possible object cycle was detected”异常，说明你正在用 System.Text.Json 序列化含有循环引用的对象（比如父子双向导航属性），而它直接抛出异常来阻止不安全行为。

为什么 System.Text.Json 不允许循环引用？

这是出于安全与设计哲学的考虑：
– 避免无限递归导致栈溢出或内存耗尽
– 不引入隐式引用跟踪机制，保持轻量和可预测性
– 强制开发者显式建模数据结构，而非依赖运行时“兜底”

解决循环引用的实用方法

没有“全局设置开关”，但有几种清晰可控的方式：

方式一：移除/断开循环引用（推荐）
在序列化前，临时清空或置空引发循环的引用属性。例如：

// 假设有 Order → Customer → Orders 循环 order.Customer.Orders = null; // 断开反向引用 var json = JsonSerializer.Serialize(order);

方式二：使用 [JsonIgnore] 特性标记
在模型定义时，对不需要序列化的导航属性加特性：

public class Customer { public int Id { get; set; } public string Name { get; set; } [JsonIgnore] // 关键：跳过该属性 public List Orders { get; set; } }

方式三：自定义 Converter 控制序列化逻辑
适用于需要更精细控制（如只序列化 ID、或按需展开一层）的场景：

public class CustomerConverter : JsonConverter { public override Customer Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) => Json

Serializer.Deserialize(ref reader, options);

public override void Write(Utf8JsonWriter writer, Customer value, JsonSerializerOptions options)  
{  
    writer.WriteStartObject();  
    writer.WriteString("name", value.Name);  
    writer.WriteNumber("id", value.Id);  
    // 不写 Orders 属性，避免循环  
    writer.WriteEndObject();  
}

}

// 使用时注册：
var options = new JsonSerializerOptions();
options.Converters.Add(new CustomerConverter());

注意：Newtonsoft.Json 仍支持 ReferenceLoopHandling

如果你必须用老方式（比如维护旧项目），可继续用 Newtonsoft.Json，并配置：

Moshi Chat

法国AI实验室Kyutai推出的端到端实时多模态AI语音模型，具备听、说、看的能力，不仅可以实时收听，还能进行自然对话。

160 查看详情 Moshi Chat

var settings = new JsonSerializerSettings { ReferenceLoopHandling = ReferenceLoopHandling.Ignore, // 或 Serialize PreserveReferencesHandling = PreserveReferencesHandling.Objects }; string json = JsonConvert.SerializeObject(obj, settings);

但这会生成 $id/$ref 元数据，前端解析需额外处理，且增加 payload 大小。

基本上就这些。System.Text.Json 的设计取舍明确：不妥协安全性，也不隐藏复杂性。处理循环引用不是靠“开个开关”，而是靠你主动梳理对象关系——这反而让数据契约更清晰。

以上就是C# 如何处理JSON中的循环引用 - JsonSerializerSettings配置的详细内容，更多请关注其它相关文章！

# 自定义 # 如何推广淘客网站 # 涧西区产品推广营销公司 # 体培营销推广策略有哪些 # 兼职网站推广怎么样 # 平谷网站建设 # 织金推广营销 # 江苏营销型网站建设费用 # 星云seo的优化 # 营销短信如何推广 # 江门优化型外贸网站建设 # 抛出 # 如何使用 # 不支持 # json # 也不 # 如果你 # 数据结构 # 序列化 # 如何处理 # 递归 # 为什么 # .net # 栈 # 前端 # js # c#