DataContractJsonSerializer序列化与向后兼容：接口默认类型指定问题

这个问题我之前也碰到过——DataContractJsonSerializer处理接口类型时，默认依赖__type字段来确定要实例化的具体类，旧数据没有这个标识的话，序列化器就会把它当成object来解析，自然就会报类型转换错误。

好在我们可以通过**自定义数据契约代理（DataContractSurrogate）**来解决这个向后兼容的问题，让序列化器在没有__type标识时，自动用你指定的默认类型（比如SystemSettings）来实例化接口。

步骤1：实现IDataContractSurrogate接口 #

我们只需要重写GetDeserializedObject方法，拦截反序列化的对象，当目标类型是ISettings且当前对象是无类型的字典（旧数据的解析结果）时，把它转换成默认的SystemSettings实例。

public class SettingsSurrogate : IDataContractSurrogate
{
    // 返回原类型，不需要修改
    public Type GetDataContractType(Type type) => type;

    // 核心：处理反序列化的对象转换
    public object GetDeserializedObject(object obj, Type targetType)
    {
        // 匹配场景：反序列化得到的是字典（旧数据无__type），目标类型是ISettings
        if (obj is Dictionary<string, object> settingsDict && targetType == typeof(ISettings))
        {
            // 方式一：手动映射字段（性能更高，适合字段固定的情况）
            return new SystemSettings
            {
                Name = settingsDict.TryGetValue("Name", out var nameVal) ? nameVal.ToString() : null,
                SysName = settingsDict.TryGetValue("SysName", out var sysNameVal) ? sysNameVal.ToString() : null
            };

            // 方式二：用序列化器自动转换（更灵活，适合字段可能变化的情况）
            // using var ms = new MemoryStream();
            // using var writer = JsonReaderWriterFactory.CreateJsonWriter(ms);
            // new DataContractJsonSerializer(typeof(SystemSettings)).WriteObject(writer, settingsDict);
            // ms.Position = 0;
            // return new DataContractJsonSerializer(typeof(SystemSettings)).ReadObject(ms);
        }

        // 其他情况保持原对象不变
        return obj;
    }

    // 以下方法都是默认实现，不需要修改
    public object GetObjectToSerialize(object obj, Type targetType) => obj;
    public object GetCustomDataToExport(Type clrType, Type dataContractType) => null;
    public object GetCustomDataToExport(MemberInfo memberInfo, Type dataContractType) => null;
    public void GetKnownCustomDataTypes(Collection<Type> customDataTypes) { }
    public Type GetReferencedTypeOnImport(string typeName, string typeNamespace, object customData) => null;
    public CodeTypeDeclaration ProcessImportedType(CodeTypeDeclaration typeDeclaration, CodeCompileUnit compileUnit) => typeDeclaration;
}

步骤2：使用自定义代理创建序列化器 #

在初始化DataContractJsonSerializer时，通过DataContractJsonSerializerSettings传入我们的代理：

var serializerSettings = new DataContractJsonSerializerSettings
{
    DataContractSurrogate = new SettingsSurrogate(),
    // 保留你原来的其他设置，比如 IgnoreExtensionDataObject = true 等
};

var serializer = new DataContractJsonSerializer(typeof(Data), serializerSettings);

原理说明 #

• 对于旧数据：没有__type字段，序列化器会把settings节点解析成Dictionary<string, object>，我们的代理会拦截这个对象，将其转换为SystemSettings实例，避免类型转换错误。
• 对于新数据：带有__type字段，序列化器会正常识别对应的具体类型（SystemSettings或PrivateSettings），代理不会干预这个过程，完美兼容新旧数据。

这样修改后，旧数据就能正常反序列化，新数据的功能也不受影响，完全解决了向后兼容的问题。

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