You need to enable JavaScript to run this app. C# Newtonsoft.Json序列化IEnumerable派生类报构造函数异常问题
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.28 20:36:04