近日，一项关于 .NET 序列化工具的隐蔽问题在技术社区引发热议：当类属性同时标注了 DefaultValueAttribute（默认值特性）并在构造函数中赋值时，使用 JSON.NET 进行反序列化后，构造函数中设置的值会被该特性定义的默认值意外覆盖。这一行为与开发者通常的直觉——构造函数优先级高于默认值——相悖，导致数据丢失或逻辑错误。

问题回溯：反序列化后的“值回滚”现象

多位开发者在 GitHub Issues 和 Stack Overflow 上报告了类似案例。例如，某 .NET 开发人员定义了一个 UserSettings 类，其中 Theme 属性在构造函数中初始化为 "Dark"，但属性上标注了 [DefaultValue("Light")]。当使用 JSON.NET 反序列化一份不包含 Theme 字段的 JSON 时，期望值是构造函数赋予的 "Dark"，实际得到的却是 "Light"。

public class UserSettings
{
    [DefaultValue("Light")]
    public string Theme { get; set; }

    public UserSettings()
    {
        Theme = "Dark"; // 构造函数中赋值为"Dark"
    }
}

类似情况还会出现在 bool、int 等值类型属性中，尤其是在配合 JsonProperty(DefaultValueHandling = DefaultValueHandling.Populate) 设置时表现更为鲜明。

根源探析：JSON.NET 默认值处理机制与构造函数执行顺序

JSON.NET 的反序列化流程通常分为两步：1）通过默认构造函数创建对象实例（或使用 ObjectCreationHandling.Replace 等设置），此时实例的 Theme 属性为 "Dark"；2）从 JSON 流中读取属性值——若 JSON 中缺失某字段，JSON.NET 会检查该属性是否具有 DefaultValueAttribute，若有，则调用特性定义的默认值覆盖已有值。

问题核心在于：JSON.NET 的 DefaultValueHandling.Populate 和 IgnoreAndPopulate 模式会在反序列化过程中，将 DefaultValueAttribute 作为字段缺失时的“补全值”写入属性，这一操作发生在构造函数执行完毕之后。而开发者的常见理解是“构造函数设置的默认值应优先于特性标注”，但 JSON.NET 的默认行为恰恰相反——它将特性视作最终的“降级默认值”。

影响范围：波及序列化配置与业务逻辑

该问题并非所有情况都会触发，它的出现依赖于 DefaultValueHandling 设置。具体而言： - 当 DefaultValueHandling 为 Ignore 或 IgnoreAndPopulate 时，缺失字段会被直接忽略（但 IgnoreAndPopulate 会写入默认值）。 - 当 DefaultValueHandling.Populate 被显式指定或继承自全局设置时，缺失字段一律用 DefaultValueAttribute 回填。

受影响场景包括： - 配置对象反序列化：如从 JSON 文件加载应用程序设置，构造函数中预置的合理默认值被覆盖。 - 数据传输对象（DTO）：在 API 接收的 JSON 缺少字段时，本应保留服务端预设值，却被特性值篡改。 - 单元测试：测试数据构建时依赖构造函数的初始化，反序列化后不符合预期。

应对策略：明确预期，规避陷阱

针对该问题，社区和微软文档给出了几种解法：

  1. 移除不必要的 DefaultValueAttribute
    如果属性值已在构造函数中设定，且不打算作为序列化时的缺失回填值，直接删除特性即可。

  2. 调整 DefaultValueHandling 设置
    在 JsonSerializerSettings 中将 DefaultValueHandling 设为 Ignore（忽略缺失字段，不写入默认值），或设为 Include（强制序列化所有字段）。例如： csharp var settings = new JsonSerializerSettings { DefaultValueHandling = DefaultValueHandling.Ignore };

  3. 使用 ShouldSerialize 方法
    自定义序列化行为，在类中实现 ShouldSerialize{PropertyName}() 方法，控制特定属性的默认值处理逻辑。

  4. 采用自定义 JsonConverter
    对于复杂场景，可创建自定义转换器，完全接管反序列化流程，手动控制构造函数与特性优先级。

行业建议：警惕“隐式覆盖”风险，加强单元测试

.NET 序列化专家指出，该问题揭示了框架默认行为隐晦的一面。开发团队在代码审查时应重点关注同时存在构造函数赋值和 DefaultValueAttribute 的属性，避免无意引入 Bug。建议在项目中使用 JSON.NET 的全局设置时，明确指定 DefaultValueHandling 策略，并在单元测试中覆盖“JSON 缺失字段”的反序列化场景，以验证实际行为是否符合业务需求。

目前，JSON.NET 官方维护团队已将此类问题收录到文档说明中，但尚未计划修改默认行为——因为改变可能破坏现有项目的兼容性。开发者需正视这一设计选择，通过代码规范规避潜在陷阱。

（完）