OpenAPI discriminator实现C#强类型代码生成的最优方案咨询

我正在开发一个API，其中单个方法需要根据类型参数生成具体子类型。我知道OpenAPI 3可以通过oneOf和discriminator实现这个功能，但用代码生成器生成强类型类时遇到了问题：目前用openapi-generator生成的代码会把子类型属性合并到单一模型里，不够简洁，也不符合强类型的要求。

我的示例OpenAPI schema如下：

content:
  application/json:
    schema:
      discriminator:
        propertyName: powerSource
        mapping:
          electricity: ../components/schemas/ElectricVehicle.yaml
          gasoline: ../components/schemas/FueledVehicle.yaml
          human-energy: ../components/schemas/PedaledVehicle.yaml
      anyOf:
        - $ref: ../components/schemas/ElectricVehicle.yaml
        - $ref: ../components/schemas/FueledVehicle.yaml
        - $ref: ../components/schemas/PedaledVehicle.yaml 

通用GET请求会返回具体子类型（比如ElectricVehicle）的属性，且powerSource属性会对应设置为对应的值。

我现在想咨询：

1. 在C#端该如何处理这种类型映射？
2. 下面这种自定义判断反序列化的伪代码方案是不是最优解？
3. 有没有能正确处理该场景的OpenAPI代码生成器？

伪代码示例：

if (Model.PowerSource == "ElectricVehicle")
    ElectricVehicle electricVehicle = Deserialize<ElectricVehicle>(getResult);

if (Model.PowerSource == "FueledVehicle")
    FueledVehicle fueledVehicle = Deserialize<FueledVehicle>(getResult);

// ...其他类型判断

一、C#端的类型映射处理 #

在C#中处理这种多态反序列化，核心是利用序列化库的原生鉴别器支持，无需手动编写大量分支判断：

• 若使用Newtonsoft.Json，可通过自定义JsonConverter或标记JsonProperty配合JsonSubtypes属性实现自动类型转换；
• 若使用System.Text.Json，可配置JsonPolymorphismOptions指定鉴别器字段与类型映射关系。

以System.Text.Json为例，配置示例：

var options = new JsonSerializerOptions
{
    PropertyNameCaseInsensitive = true,
    PolymorphismOptions = new JsonPolymorphismOptions
    {
        TypeDiscriminatorPropertyName = "powerSource",
        IgnoreUnrecognizedTypeDiscriminators = true,
        DerivedTypes =
        {
            new JsonDerivedType(typeof(ElectricVehicle), "electricity"),
            new JsonDerivedType(typeof(FueledVehicle), "gasoline"),
            new JsonDerivedType(typeof(PedaledVehicle), "human-energy")
        }
    }
};

// 直接反序列化为基类，会自动转换为对应子类型
Vehicle vehicle = JsonSerializer.Deserialize<Vehicle>(getResult, options);

二、自定义判断伪代码是否为最优解 #

你的伪代码方案并非最优解，存在以下问题：

• 代码冗余：新增子类型时必须手动添加判断分支；
• 维护成本高：鉴别器值与类型的映射分散在业务代码中，和OpenAPI定义脱节；
• 易出错：手动编写判断逻辑可能出现拼写错误或遗漏类型。

更优的方式是借助序列化库的多态特性，或使用代码生成器直接生成带多态配置的模型类。

三、支持多态的OpenAPI代码生成器 #

推荐以下能正确处理OpenAPI 3 oneOf+discriminator场景的代码生成器：

• NSwag：对C#多态支持完善，生成的代码会自动添加Newtonsoft.Json或System.Text.Json的多态配置属性（如JsonDerivedType、JsonPolymorphic），无需额外修改即可直接使用；
• AutoRest：微软官方代码生成工具，针对C#可生成带多态处理的客户端代码，能准确识别并映射鉴别器规则；
• OpenAPI Generator（优化配置）：你之前使用的openapi-generator也支持该场景，只需添加配置参数：生成C#代码时传入--additional-properties=discriminatorUsePolymorphism=true，即可生成基类+子类的分层结构，而非合并所有属性到单一模型。

示例openapi-generator生成命令：

openapi-generator generate -i your-api-spec.yaml -g csharp -o ./generated-client --additional-properties=discriminatorUsePolymorphism=true

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