C# record struct新增属性反序列化默认状态及兼容方案问询

反序列化时新增属性的默认状态 #

当反序列化不包含新增属性的老数据时，新增的两个属性会被赋值为对应类型的默认值：

• DateTime类型的默认值是DateTime.MinValue（即0001年1月1日 00:00:00）
• int类型的默认值是0

因为record struct是值类型，主流序列化器（如System.Text.Json、Newtonsoft.Json）在找不到对应字段时，会自动填充值类型的默认值，不会抛出缺失字段的异常。

不中断现有代码的最佳处理方式 #

1. 给新增属性设置业务友好的默认值 #

修改record struct的主构造器，给新增参数指定默认值，替代类型本身的极端默认值（比如DateTime.MinValue在业务中通常属于无效时间），同时兼容新老实例的创建：

public record struct RecordA(ABC data, DateTime dateTime = default, int count = 0);

老数据反序列化后，dateTime和count会直接使用你指定的默认值，业务逻辑处理更安全。

2. 配置序列化器忽略缺失成员 #

以System.Text.Json为例，序列化/反序列化时显式配置忽略缺失成员，避免潜在的序列化异常：

var options = new JsonSerializerOptions
{
    IgnoreMissingMembers = true,
    PropertyNameCaseInsensitive = true // 可选，处理大小写不一致问题
};
var record = JsonSerializer.Deserialize<RecordA>(oldDataJson, options);

3. 业务逻辑层做兼容判断 #

在读取数据后的业务代码中，判断新增属性是否为默认值（或业务定义的无效值），分支处理新老逻辑：

var record = DeserializeRecordA(oldData);
if (record.dateTime == DateTime.MinValue)
{
    // 执行原有业务逻辑，不依赖新增属性
}
else
{
    // 执行新逻辑，使用dateTime和count属性
}

4. 保持属性名称与序列化字段一致 #

如果序列化使用了特定命名规则（如驼峰命名），可以用[JsonPropertyName]属性显式指定属性对应的序列化字段名，避免因命名规则差异导致反序列化失败：

public record struct RecordA(
    ABC data,
    [JsonPropertyName("dateTime")] DateTime dateTime = default,
    [JsonPropertyName("count")] int count = 0);

内容的提问来源于stack exchange，提问作者Arpa Mukherjee