C# XML序列化中的循环引用问题详解（小白也能学会的循环引用处理技巧）

什么是循环引用？

循环引用指的是对象 A 引用对象 B，而对象 B 又反过来引用对象 A，形成一个闭环。例如：

public class Person{    public string Name { get; set; }    public Person Friend { get; set; } // 引用另一个 Person}// 使用示例var alice = new Person { Name = "Alice" };var bob = new Person { Name = "Bob" };alice.Friend = bob;bob.Friend = alice; // 形成循环引用！

当你尝试对 alice 或 bob 进行 XML 序列化时，XmlSerializer 会陷入无限递归，最终抛出 InvalidOperationException 异常。

为什么 XmlSerializer 不支持循环引用？

与 JSON 序列化器（如 Newtonsoft.Json）不同，C# 内置的 XmlSerializer 在设计上不支持对象图中的循环引用。它采用的是“深度优先”的序列化策略，一旦遇到循环就会无限递归下去，因此 .NET 框架直接禁止了这种行为。

解决方案一：避免序列化引用属性

最简单的方法是使用 [XmlIgnore] 特性，告诉序列化器忽略该属性：

public class Person{    public string Name { get; set; }    [XmlIgnore] // 忽略此属性，不参与序列化    public Person Friend { get; set; }}

这种方法适用于你不需要保存引用关系的场景。但如果你确实需要保留某种形式的关联信息，就需要更高级的方案。

解决方案二：使用 ID 引用代替对象引用

我们可以为每个对象分配唯一 ID，并在序列化时只存储 ID 而非整个对象：

public class Person{    public int Id { get; set; }    public string Name { get; set; }    [XmlIgnore]    public Person Friend { get; set; }    [XmlElement("FriendId")]    public int? FriendId    {        get => Friend?.Id;        set        {            // 反序列化时需通过 ID 查找实际对象（需额外逻辑）        }    }}

这样，XML 中只会保存 FriendId，避免了对象嵌套。反序列化后，你需要根据 ID 重建引用关系——这通常需要一个全局的对象注册表（如 Dictionary<int, Person>）。

解决方案三：改用 DataContractSerializer（可选）

如果你必须保留完整的对象图且支持循环引用，可以考虑使用 DataContractSerializer，它原生支持 IsReference=true：

[DataContract(IsReference = true)]public class Person{    [DataMember]    public string Name { get; set; }    [DataMember]    public Person Friend { get; set; }}// 使用 DataContractSerializervar serializer = new DataContractSerializer(typeof(Person));using (var writer = XmlWriter.Create("person.xml")){    serializer.WriteObject(writer, alice);}

注意：这生成的是 XML，但格式与 XmlSerializer 不同，且需要手动管理序列化过程。

总结

在 C# XML 序列化中处理循环引用，核心思路是打破递归链。你可以：

• 使用 [XmlIgnore] 忽略引用属性；
• 用 ID 代替对象引用，实现“软链接”；
• 切换到支持引用的序列化器如 DataContractSerializer。

选择哪种方法取决于你的具体需求。对于大多数应用场景，ID 引用法既安全又灵活，是推荐的做法。

希望这篇关于 C# XML序列化 和 循环引用处理 的教程能帮助你顺利解决问题。掌握这些 C#教程 中的实用技巧，将大大提升你的开发效率和代码健壮性。更多 XML序列化技巧，欢迎持续关注我们的技术分享！