Spring @RequestBody继承问题：如何解析UserDto子类实例

这个问题我之前做项目时也卡过好久！核心就是默认的JSON序列化器没办法自动判断基类对应的具体子类，得给它加个「类型标识」来区分不同的子类型才行。下面分几种常见技术栈给你具体的解决方法：

一、.NET Core（用默认的System.Text.Json） #

1. 给基类加类型鉴别特性 #

直接在UserDto基类上配置子类和对应的标识值，序列化器会自动根据JSON里的标识字段来实例化对应子类：

using System.Text.Json.Serialization;

// 自定义类型标识字段名为"userType"，也可以用默认的"$type"
[JsonPolymorphic(TypeDiscriminatorPropertyName = "userType")]
// 指定子类和对应的标识值
[JsonDerivedType(typeof(ClientDto), typeDiscriminator: "client")]
[JsonDerivedType(typeof(OwnerDto), typeDiscriminator: "owner")]
public class UserDto
{
    public string Id { get; set; }
    public string Name { get; set; }
}

public class ClientDto : UserDto
{
    public string ClientNumber { get; set; }
}

public class OwnerDto : UserDto
{
    public string BusinessLicense { get; set; }
}

2. 控制器直接接收基类参数 #

控制器方法里直接写UserDto作为参数就行，前端传的JSON里只要带上"userType": "client"或者"owner"，序列化器就会自动转成对应的子类实例：

{
  "userType": "client",
  "Id": "U001",
  "Name": "张三",
  "ClientNumber": "C001"
}

二、.NET老项目（用Newtonsoft.Json） #

如果你的项目还在用Json.NET，步骤稍微有点不一样：

1. 配置基类的子类型映射 #

可以用JsonSubtypes这个NuGet包来简化配置，也可以直接用Newtonsoft的原生特性：

using Newtonsoft.Json;
using JsonSubtypes;

// 指定用"userType"字段来区分类型
[JsonConverter(typeof(JsonSubtypes), "userType")]
// 绑定子类和对应的标识值
[JsonSubtypes.KnownSubType(typeof(ClientDto), "client")]
[JsonSubtypes.KnownSubType(typeof(OwnerDto), "owner")]
public class UserDto
{
    public string Id { get; set; }
    public string Name { get; set; }
    // 可以把userType作为属性暴露出来，方便后续逻辑判断
    public string UserType { get; set; }
}

2. 控制器接收参数 #

同样直接接收UserDto类型，前端传的JSON带"userType"字段就可以自动解析成对应子类。

三、手动解析（适合不想加特性的场景） #

如果不想用特性来耦合代码，也可以在控制器里手动判断类型再解析：

[HttpPost]
public IActionResult AddUser([FromBody] JsonElement jsonBody)
{
    // 先从JSON里取出类型标识
    if (!jsonBody.TryGetProperty("userType", out var typeElement))
    {
        return BadRequest("缺少用户类型标识");
    }

    var userType = typeElement.GetString();
    UserDto user = userType switch
    {
        "client" => JsonSerializer.Deserialize<ClientDto>(jsonBody),
        "owner" => JsonSerializer.Deserialize<OwnerDto>(jsonBody),
        _ => throw new ArgumentException($"不支持的用户类型：{userType}")
    };

    // 这里写你的业务逻辑
    return Ok($"成功创建{userType}用户：{user.Name}");
}

这种方式更灵活，但代码量会多一些，适合需要自定义解析逻辑的场景。

几个要注意的点 #

• 前端传递的类型标识必须和后端配置的完全一致（大小写也要注意！）
• 如果是跨语言调用，要确保双方约定好标识字段和值的规则
• .NET Core的System.Text.Json在.NET 5+版本对多态序列化的支持更完善，低版本可能需要额外配置

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