二进制序列化版本兼容问题：新增字段后无法反序列化旧数据

先直接回应你的核心疑问：

• 为什么自动序列化类加[OptionalField]就能自动赋默认值，但你的类不行？
• 检查SerializationEntry数组是正确的处理方式，但有更简洁的优化方案；
• 为什么[OptionalField]好像没起作用？

核心原因：ISerializable是手动控制序列化逻辑 #

对于只标记[Serializable]但不实现ISerializable的类，.NET框架会自动处理序列化流程——当你新增带[OptionalField(VersionAdded = N)]的字段时，框架在反序列化旧数据时会自动给该字段分配类型默认值（比如int是0，引用类型是null）。

但当你实现ISerializable接口时，所有序列化/反序列化的细节都由你编写的GetObjectData方法和反序列化构造函数完全控制。框架不会替你自动处理可选字段，哪怕你加了[OptionalField]特性——这个特性更多是给框架和工具做版本标记用的，本身不会自动修改你的手动逻辑。

这就是为什么你直接用info.GetValue("x", typeof(int))读取新字段时，旧数据里没有就会抛出SerializationException：因为GetValue方法本身要求字段必须存在，找不到就报错，和[OptionalField]无关。

正确的处理方案 #

方案1：优先使用SerializationInfo.TryGetValue（推荐）

从.NET Framework 4.5、.NET Core 1.0开始，SerializationInfo新增了TryGetValue方法——它会尝试读取指定字段，不存在时返回false，不会抛出异常，直接给你类型默认值或者你自定义的默认值，代码非常简洁：

[Serializable]
public class YourClass : ISerializable
{
    // 旧字段
    public int OldProp { get; set; }

    // 新增的可选字段，标记OptionalField
    [OptionalField(VersionAdded = 2)]
    public int NewProp { get; set; }

    // 反序列化构造函数
    protected YourClass(SerializationInfo info, StreamingContext context)
    {
        // 旧字段直接读取（旧数据肯定存在）
        OldProp = (int)info.GetValue("OldProp", typeof(int));

        // 处理新字段：用TryGetValue，不存在就用默认值0
        info.TryGetValue("NewProp", out NewProp);
        
        // 也可以自定义默认值：
        // if (!info.TryGetValue("NewProp", out int newVal))
        // {
        //     NewProp = 100; // 你想要的默认值
        // }
        // else
        // {
        //     NewProp = newVal;
        // }
    }

    public void GetObjectData(SerializationInfo info, StreamingContext context)
    {
        // 序列化所有字段（包括新字段）
        info.AddValue("OldProp", OldProp);
        info.AddValue("NewProp", NewProp);
    }
}

方案2：遍历SerializationEntry数组（兼容旧.NET版本）

如果你的项目还在使用.NET Framework 4.5之前的版本，没有TryGetValue方法，那就只能遍历info里的所有SerializationEntry，检查是否存在目标字段：

protected YourClass(SerializationInfo info, StreamingContext context)
{
    OldProp = (int)info.GetValue("OldProp", typeof(int));
    NewProp = 0; // 默认值

    foreach (SerializationEntry entry in info)
    {
        if (entry.Name == "NewProp")
        {
            NewProp = (int)entry.Value;
            break;
        }
    }
}

这个方式是完全正确的，只是代码稍微繁琐一点。

关于[OptionalField]特性的作用 #

虽然它不会直接帮你处理反序列化逻辑，但还是建议一定要加上：

1. 它明确标记了这个字段是后续版本新增的，是代码可读性的重要提示；
2. 如果未来你把类改回自动序列化（不再实现ISerializable），这个特性会自动生效；
3. 一些第三方序列化工具或版本兼容工具会识别这个特性，辅助处理兼容性。

总结一下：

• 实现ISerializable的类必须手动处理可选字段的读取，框架不会自动赋默认值；
• 能用TryGetValue就优先用，代码更简洁优雅；
• 遍历SerializationEntry是正确的兼容方案，适合旧版本环境；
• 记得给新字段加上[OptionalField]特性做版本标记。

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