Web API控制器中泛型类型接收多类型VehicleDto的方案咨询

不用拆分成多个API，完全可以通过JSON多态反序列化来实现单个接口接收包含不同T类型的VehicleDto列表，我给你详细说下具体步骤：

第一步：给Motor和Machine定义共同基类 #

首先得让这两个类有一个公共的抽象基类（或接口），这样泛型DTO的列表才能容纳不同的子类实例：

// 抽象基类，作为Motor和Machine的共同父类
[JsonDerivedType(typeof(Motor), typeDiscriminator: "Motor")]
[JsonDerivedType(typeof(Machine), typeDiscriminator: "Machine")]
[JsonPolymorphic(TypeDiscriminatorPropertyName = "Type")] // 自定义判别式字段名
public abstract class VehicleDetailBase { }

// 你的Motor类继承基类
public class Motor : VehicleDetailBase
{
    public int Horsepower { get; set; }
    // 其他Motor专属属性
}

// 你的Machine类继承基类
public class Machine : VehicleDetailBase
{
    public int LoadCapacity { get; set; }
    // 其他Machine专属属性
}

这里用了.NET 6+的System.Text.Json特性：

• [JsonDerivedType]标记允许的子类和对应的类型判别值
• [JsonPolymorphic]自定义判别式字段（比如这里用"Type"代替默认的"$type"）

第二步：调整泛型DTO和控制器方法 #

把你的VehicleDto<T>改成基于基类的泛型，然后控制器方法接收List<VehicleDto<VehicleDetailBase>>：

// 你的泛型DTO，T约束为基类
public class VehicleDto<T> where T : VehicleDetailBase
{
    public int Id { get; set; }
    public T Detail { get; set; }
    // 其他公共属性
}

// 控制器动作方法
[HttpPost("vehicles")]
public IActionResult ReceiveVehicles([FromBody] List<VehicleDto<VehicleDetailBase>> vehicles)
{
    foreach (var vehicle in vehicles)
    {
        // 通过类型判断处理不同的Detail
        if (vehicle.Detail is Motor motor)
        {
            // 处理Motor类型的逻辑，比如访问motor.Horsepower
        }
        else if (vehicle.Detail is Machine machine)
        {
            // 处理Machine类型的逻辑，比如访问machine.LoadCapacity
        }
    }
    return Ok();
}

第三步：客户端发送符合要求的JSON #

客户端只需要在Detail对象里带上我们定义的Type字段，就能让后端正确反序列化对应的类型：

[
    {
        "Id": 1,
        "Detail": {
            "Type": "Motor",
            "Horsepower": 350
        }
    },
    {
        "Id": 2,
        "Detail": {
            "Type": "Machine",
            "LoadCapacity": 10000
        }
    }
]

为什么这比多API方案好？ #

• 统一接口：客户端只需要对接一个API，不用根据类型区分请求地址，维护成本更低
• 扩展性强：以后新增其他车辆类型（比如Bike），只需要新增继承VehicleDetailBase的类，加上[JsonDerivedType]标记即可，完全不用修改控制器代码
• 逻辑集中：所有车辆类型的处理逻辑都在同一个方法里，代码结构更清晰

额外注意事项 #

• 如果你用的是.NET 5及以下，或者习惯用Newtonsoft.Json（Json.NET），可以通过配置TypeNameHandling来实现类似效果，但要注意安全风险（避免反序列化恶意类型）
• 类型判别式的值必须唯一，不能重复，否则会导致反序列化失败
• 确保所有可能的T类型都继承自同一个基类/接口，否则泛型列表无法容纳不同类型

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