近日，知名.NET开发者社区曝出一则令众多程序员困惑的技术问题：在使用广泛流行的JSON序列化库Newtonsoft JSON.NET进行反序列化操作时，系统会自动忽略参数化构造函数中的默认值设定。这一行为在复杂的对象层次结构中引发了难以追踪的数据丢失问题，影响了大量依赖该库的企业级应用。

问题重现：默认值为何消失？

为了直观展示这一问题，开发者给出了典型的复现代码。假设有如下类定义：

public class UserConfig
{
    public string Name { get; }
    public int Timeout { get; }

    public UserConfig(string name, int timeout = 30)
    {
        Name = name;
        Timeout = timeout;
    }
}

当使用JSON字符串反序列化时，如果JSON中只包含Name字段而不包含Timeout：

var json = "{\"Name\": \"Alice\"}";
var config = JsonConvert.DeserializeObject<UserConfig>(json);

预期的行为是Timeout应该保持默认值30，但实际上，反序列化后Timeout被设置为0。这一现象的本质在于Newtonsoft JSON.NET在调用参数化构造函数时，并未将JSON中缺失字段所对应的参数默认值纳入考虑，而是直接使用了C#值类型的默认值（如int为0）。

根源剖析：序列化与构造函数机制的博弈

深入技术层面，这个问题的根源在于Newtonsoft JSON.NET的反序列化策略。当库检测到目标类型没有无参数构造函数时，它会寻找参数最匹配的构造函数进行调用。在这个过程中，对于JSON中未提供的字段，库不会去读取C#参数默认值元数据，而直接采用参数类型的默认值（int为0，string为null等）。

这一设计决策与C#的构造函数默认值语义存在偏差。C#语言规范明确规定，在显式调用构造函数时，未提供的可选参数应取其声明的默认值。Newtonsoft JSON.NET之所以选择忽略这一规则，主要是为了简化反序列化逻辑，避免对参数默认值的反射读取可能带来的性能损耗。

此外，这一行为在不同版本的Newtonsoft JSON.NET中保持一致，并且与微软官方的System.Text.Json库也存在差异——后者在处理参数化构造函数时，对默认值的处理更加符合C#语义。跨库行为的不一致进一步加剧了开发者的困惑。

社区热议：临时方案与长期建议

问题曝光后，在Stack Overflow、GitHub Issues以及各大.NET技术社区引发了热烈讨论。开发者们纷纷提出临时解决方案：

  1. 显式传递默认值：在构造函数中，对可能缺失的参数手动赋予默认值，而非依赖C#参数默认值。但这违反了“单一数据源”原则。

  2. 使用自定义转换器：实现JsonConverter子类，在反序列化过程中手动处理缺失字段的默认值逻辑。这种方法灵活但增加了代码复杂度。

  3. 为对象添加无参数构造函数：如果业务允许，添加无参数构造函数并在内部设置默认值，或者使用[JsonConstructor]属性指定特定的构造函数。

  4. 改用System.Text.Json：从.NET Core 3.0起，官方库System.Text.Json对参数化构造函数的默认值处理更为合理。但对于遗留项目，迁移成本较高。

多位社区专家建议，最佳实践是在设计DTO（数据传输对象）时，优先使用无参数构造函数配合属性初始化器，或者采用记录类型（record）以简化构造过程。对于必须使用参数化构造函数的场景，应在构造函数内部明确处理参数为默认值的逻辑。

总结与展望

Newtonsoft JSON.NET忽略参数化构造函数默认值的问题，虽然在不复杂的对象层次结构中影响有限，但在企业级应用中可能引发数据完整性问题。随着.NET生态向System.Text.Json迁移，这一冲突有望逐步缓解。开发者在使用序列化库时，应充分了解其与C#语言特性之间的细微差异，以便在设计和编码阶段规避潜在风险。

对于仍在维护Newtonsoft JSON.NET遗留项目的团队，建议建立统一的反序列化处理策略，或在代码审查中重点关注构造函数默认值的使用场景，确保数据转换的准确性和一致性。