C# Newtonsoft.Json序列化IEnumerable派生类报构造函数异常问题
Newtonsoft.Json 继承IEnumerable的自定义类序列化抛构造函数参数异常的解决方案
异常触发本质
Newtonsoft.Json 对实现IEnumerable<T>接口的类型,默认优先按照集合类型的规则处理序列化逻辑:
- 集合类型的序列化/反序列化流程,要求目标类必须满足构造函数的匹配规则:要么提供无参数公共构造函数,要么提供仅接收单个
IEnumerable<string>类型参数的构造函数,用来承接集合元素的填充操作 - 本次的
BPlusTreeNode<T>基类虽实现了IEnumerable<string>接口,但类本身是存储B+树节点结构化属性(键列表、磁盘路径、叶子节点指针、阶数等)的普通业务类,并非纯粹的集合类型,因此不符合默认的集合构造函数校验规则,在序列化阶段直接抛出构造函数参数不匹配的异常。
修复方式
在需要按普通对象规则序列化的、继承了IEnumerable接口的自定义类上方,添加[JsonObject]特性,强制覆盖序列化器的默认集合类型判断逻辑,明确告知序列化器该类型需按照结构化对象的规则处理。
修正后的代码示例:
// 强制按普通对象规则序列化 [JsonObject] public class BPlusTreeNode<T> : IEnumerable<string> where T : IComparable { [JsonProperty(Required = Required.AllowNull)] protected List<T> keys = null; [JsonProperty(Required = Required.AllowNull)] protected List<string> paths = null; [JsonProperty(Required = Required.Always)] protected bool isLeaf = false; [JsonProperty(Required = Required.Always)] protected int order; [JsonProperty(Required = Required.AllowNull)] protected string path; [JsonProperty(Required = Required.AllowNull)] protected string next = null; [JsonProperty(Required = Required.AllowNull)] protected string prev = null; [JsonConstructor] public BPlusTreeNode(List<T> keys, List<string> paths, bool isLeaf, string path, string next, string prev, int order = 10) { this.keys = keys; this.paths = paths; this.isLeaf = isLeaf; this.path = path; this.next = next; this.prev = prev; this.order = order; } // 原有IEnumerable接口的实现逻辑保持不变 } public class BPlusTreeLeaf<T> : BPlusTreeNode<T> where T : IComparable { [JsonConstructor] public BPlusTreeLeaf(List<T> keys, List<string> paths, bool isLeaf, string path, string next, string prev, int order = 10) : base(keys, paths, isLeaf, path, next, prev, order) { } }
补充说明
- 无需为了适配集合校验规则修改原有构造函数的参数列表,
[JsonObject]的规则优先级高于序列化器的默认类型推断逻辑 - 原序列化代码无需调整,添加特性后即可正常识别
[JsonConstructor]标记的构造函数,按原有属性配置完成序列化流程 - 如果类中实现IEnumerable接口的逻辑仅用于业务代码遍历、不需要参与序列化过程,也可以给枚举实现方法追加
[JsonIgnore]特性,避免接口逻辑对序列化流程产生额外干扰。
内容的提问来源于stack exchange,提问作者picki23
相关产品推荐
相关产品推荐

