ASP.NET Core FromBody绑定含接口字段的类时参数为空求助

核心问题在于后端APIGateway没有配置对应的JSON反序列化类型处理逻辑——你前端已经通过TypeNameHandling.All在JSON中嵌入了类型标识（比如InventoryList、CreateDocumentCommand的具体类型信息），但ASP.NET Core默认不会自动解析这些标识，导致后端无法将JSON映射到接口对应的实现类，最终documentCommand绑定为null。

具体解决步骤 #

1. 统一后端的JSON序列化配置（使用Newtonsoft.Json） #

因为你前端用的是Newtonsoft.Json（JsonConvert），后端必须同步配置相同的序列化规则，才能识别JSON中的$type字段：

.NET 6+（Program.cs）

在服务配置中添加NewtonsoftJson支持并开启类型处理：

builder.Services.AddControllers()
    .AddNewtonsoftJson(options =>
    {
        // 和前端保持一致，推荐用Auto（更安全）或All
        options.SerializerSettings.TypeNameHandling = TypeNameHandling.All;
    });

.NET 5及更早版本（Startup.cs）

在ConfigureServices方法中配置：

services.AddControllers()
    .AddNewtonsoftJson(options =>
    {
        options.SerializerSettings.TypeNameHandling = TypeNameHandling.All;
    });

2. 给CreateDocumentCommand的构造器标记[JsonConstructor] #

你的命令类有带参数的构造器，Newtonsoft.Json需要明确知道用哪个构造器实例化对象，否则可能因构造器匹配失败导致反序列化异常：

public class CreateDocumentCommand : Command, ICreateDocumentCommand
{
    [JsonConstructor]
    public CreateDocumentCommand(IDocument document, ICommand command) : base(command.CorrelationId, command.SocketId)
    {
        this.Document = document;
    }

    public IDocument Document { get; set; }
}

3. 确认请求Content-Type正确性 #

虽然你前端已经设置了application/json，但可以再验证下请求头里的Content-Type是否正确发送，避免因媒体类型不匹配导致绑定失败。

为什么之前的尝试没生效？ #

• 你添加构造器、标记[JSONConstructor]但没配置后端的TypeNameHandling，后端无法解析JSON中的类型标识，没法把IDocument反序列化为具体的InventoryList实例，最终整个命令对象绑定失败。
• 改成ICreateDocumentCommand作为参数也没用——本质还是后端不知道如何将JSON反序列化为这个接口的具体实现类。

额外注意事项 #

• TypeNameHandling.All会在所有JSON中嵌入类型信息，内部系统使用没问题，但对外暴露的API建议改用TypeNameHandling.Auto（只在必要时嵌入类型信息），降低反序列化攻击风险。
• 尽量保持前后端Newtonsoft.Json版本一致，避免版本差异导致的序列化逻辑不兼容。

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