ASP.NET Core Web API JSON参数自动反序列化失效问题及解决

我来帮你理清这个问题的来龙去脉和解决办法：

问题根源 #

你的CreateDocumentCommand类包含IDocument接口类型的属性，ASP.NET MVC默认的模型绑定器没有启用TypeNameHandling.Auto配置——这个配置会让序列化器在JSON中嵌入类型信息，反序列化时才能确定要把接口属性实例化成哪个具体实现类。这就是为什么手动反序列化时你显式指定了这个配置就能成功，而MVC自动反序列化时documentCommand会变成null的核心原因。

解决方案一：全局配置Newtonsoft.Json（推荐） #

如果你的项目使用的是Newtonsoft.Json（很多ASP.NET Core项目会通过AddNewtonsoftJson引入），可以在全局配置中统一设置序列化规则，这样所有MVC的模型绑定都会自动应用这些配置，不用逐个类添加特性：

// 在Program.cs（ASP.NET Core 6+）或Startup.cs的ConfigureServices方法中
services.AddControllers()
    .AddNewtonsoftJson(options =>
    {
        options.SerializerSettings.TypeNameHandling = TypeNameHandling.Auto;
        options.SerializerSettings.NullValueHandling = NullValueHandling.Ignore;
        options.SerializerSettings.MissingMemberHandling = MissingMemberHandling.Ignore;
    });

解决方案二：自定义JsonConverter（你的方案优化） #

如果你不想全局修改配置，只需要在特定类上应用规则，你自己实现的ConcreteTypeConverter<T>是个不错的选择。不过要注意几个细节：

1. 给目标类添加转换器特性：

[JsonConverter(typeof(ConcreteTypeConverter<CreateDocumentCommand>))]
public class CreateDocumentCommand : Command, ICreateDocumentCommand 
{ 
    public CreateDocumentCommand() { } 
    public IDocument Document { get; set; } 
}

2. 你的转换器实现中，通过在ReadJson方法里手动设置序列化配置，让反序列化器能识别接口的具体实现类。另外你通过CanRead的逻辑避免了循环引用异常，但要注意静态变量read可能存在线程安全问题，如果是高并发场景，可以考虑用更安全的方式处理（比如基于上下文的标记）。完整转换器代码：

public class ConcreteTypeConverter<T> : JsonConverter 
{
    static bool read = false;

    public override bool CanConvert(Type objectType) 
    {
        return typeof(T).IsAssignableFrom(objectType);
    }

    public override object ReadJson(JsonReader reader, Type objectType, object existingValue, JsonSerializer serializer) 
    {
        serializer.TypeNameHandling = TypeNameHandling.Auto;
        serializer.NullValueHandling = NullValueHandling.Ignore;
        serializer.MissingMemberHandling = MissingMemberHandling.Ignore;
        return serializer.Deserialize<T>(reader);
    }

    public override void WriteJson(JsonWriter writer, object value, JsonSerializer serializer) 
    {
        serializer.Serialize(writer, value);
    }

    public override bool CanWrite => false;

    public override bool CanRead 
    { 
        get 
        { 
            read = !read; 
            return read; 
        } 
    }
}

总结 #

• 全局配置适合整个项目需要统一序列化规则的场景，省心省力；
• 自定义转换器适合局部场景，灵活性更高，但要注意线程安全等细节。

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