近日，C# 开发者社区中关于“JSON 反序列化后对象中的 JsonPropertyName 属性仍被保留”的讨论持续升温。这一现象在使用 System.Text.Json 和 Newtonsoft.Json 两大主流 JSON 库时均有出现，但背后的行为差异和潜在影响，正成为众多 .NET 开发者关注的焦点。

背景：JsonPropertyName 在反序列化中的角色

在 C# 中，JsonPropertyName 属性（位于 System.Text.Json.Serialization 命名空间）用于指定 JSON 反序列化时字段或属性对应的键名。例如，一个 User 类中定义 [JsonPropertyName("user_name")] public string UserName { get; set; }，则 JSON 键 "user_name" 会被映射到 UserName 属性。这一机制允许代码中的成员命名遵循 C# 约定（PascalCase），同时与外部 JSON 格式（如 snake_case）保持兼容。

然而，最近开发者发现：在某些场景下，反序列化后的对象实例中，JsonPropertyName 特性的元数据并未被丢弃，而是被“保留”在了对象的内部状态中。这意味着，当再次将对象序列化为 JSON 时，库会优先使用 JsonPropertyName 指定的键名，而非当前属性名。这一行为虽然符合预期，但在一些需要动态修改属性名或进行深度克隆的场景中，可能引发意料之外的结果。

两大库的行为差异：保留与遗忘

1. System.Text.Json（默认行为保留）

System.Text.Json 自 .NET Core 3.0 起作为官方 JSON 库引入。默认情况下，反序列化仅使用 JsonPropertyName 进行映射，但不会在实例中“存储”该属性。然而，当使用 JsonSerializerOptions 中的 PropertyNameCaseInsensitive 或自定义转换器时，可能会通过反射 / 元数据 EMIT 保留原始 JsonPropertyName 信息。

例如，以下代码：

var json = "{\"user_name\":\"Alice\"}";
var user = JsonSerializer.Deserialize<User>(json);
var jsonAgain = JsonSerializer.Serialize(user);

输出的 JSON 依然是 {"UserName":"Alice"}（属性名采用 CLR 属性名），而非保留 user_name。但若定义 JsonSerializerOptions 并设置了 PropertyNamingPolicy = JsonNamingPolicy.SnakeCaseLower，则序列化时会根据命名策略重新生成键名，与 JsonPropertyName 无关。

关键点：System.Text.Json 默认不会在反序列化后的对象中持久化 JsonPropertyName，其序列化完全由选项和反射决定。但部分开发者发现，当使用 JsonSerializerContext 源生成器或自定义转换器时，若转换器内部缓存了 JsonPropertyName，则可能产生保留效果。

2. Newtonsoft.Json（保留行为更突出）

Newtonsoft.Json 是社区广泛使用的经典库。其 JsonPropertyAttribute 与 JsonPropertyName 功能类似。在 Newtonsoft.Json 中，反序列化后，JsonPropertyAttribute 的元数据默认被保留在类型的 JsonPropertyCollection 中，并且可以通过 JsonSerializerSettings 中的 ContractResolver 访问。这意味着，再次序列化时，除非手动清除或使用不同的设置，否则库会继续使用原始 JsonProperty 指定的名称。

示例：

var user = JsonConvert.DeserializeObject<User>("{\"user_name\":\"Bob\"}");
var serialized = JsonConvert.SerializeObject(user); // 输出 {"user_name":"Bob"}

这一行为让许多从较旧项目迁移到 System.Text.Json 的开发者感到困惑，因为两个库的默认策略不一致。

社区热议：是特性还是陷阱？

这一现象在 Stack Overflow 和 GitHub Issues 上引发了广泛讨论。部分开发者认为，JsonPropertyName 的保留是合理的——它确保了序列化与反序列化的一致性，特别是在使用相同 JsonSerializerSettings 时。然而，另一些开发者指出，在微服务架构中，同一模型可能对应不同上下文的 JSON 格式要求，保留固定映射会导致灵活性降低。

例如，一个 Product 类在订单服务中需要以 product_id 作为键，但在库存服务中需要 sku。若反序列化后对象保留了 JsonPropertyName("product_id")，则无法直接重用于库存接口，除非显式覆盖。

最佳实践与建议

针对这一问题，微软官方文档及社区专家给出以下建议：

  1. 明确使用策略：在项目团队内部约定统一的 JSON 序列化配置，避免混合使用不同库或策略。
  2. 使用 JsonSerializerOptions 动态控制：在 System.Text.Json 中，可通过 PropertyNamingPolicy 统一管理命名策略，而非依赖单个属性上的 JsonPropertyName。
  3. 利用 JsonIgnore 与条件序列化：若需在特定场景跳过保留的属性，可使用 [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingDefault)] 做细粒度控制。
  4. 检测与调试：使用反射检查对象时，可通过 typeof(User).GetCustomAttributes() 验证 JsonPropertyName 是否被挂载到属性上，而非对象实例上。

展望：未来版本的潜在改进

.NET 团队在 .NET 8 中已开始改善源生成器的元数据保留逻辑，并计划在后续版本中允许用户通过 JsonSerializerOptions 的 IgnoreReadOnlyFields 或类似选项，控制是否在反序列化后“忘记”原始映射。同时，社区也呼吁 Newtonsoft.Json 在后续更新中增加类似 RetainOriginalJsonProperty 的枚举开关。

结语

JsonPropertyName retained 现象并非 bug，而是两个主流 JSON 库设计哲学的差异体现。对于开发者而言，理解这一机制是构建健壮序列化逻辑的基础。无论是选择 System.Text.Json 的“无状态”模式，还是 Newtonsoft.Json 的“记忆”模式，清晰的设计决策和充分的单元测试，才是避免生产事故的关键。

（全文约980字）