OpenAPI生成类实现Schema继承的方法咨询

我是OpenAPI新手，想实现Schema继承效果，现有Vehicle和Car两个对象，Car需要继承Vehicle。但用OpenAPI Generator生成代码后，Car类只是把Vehicle的属性复制到自己里面，并没有真正继承Vehicle类，请问该怎么配置才能让生成的类实现继承关系？

原Schema配置（问题所在） #

vehicle:
  type: object
  properties:
    vehicleProperty:
      type: string
      description: "property for vehicle"

car:
  type: object
  oneOf:
    - $ref: '#/components/schemas/vehicle'
    - type: object
  properties:
    carProperty:
      type: string
      description: "property for car"

问题原因 #

你当前用oneOf的写法，只是让Car的结构包含Vehicle的属性，但OpenAPI Generator不会把这种逻辑解析为类继承关系，只会简单把父Schema的属性平铺到子类里。

正确配置方案 #

1. 修改Schema，使用allOf实现继承语义 #

要让Generator识别继承关系，需要用allOf来引用父Schema，这是OpenAPI里表达“继承/扩展”的标准写法。如果需要支持多态（比如后续还要加Truck等子类），可以配合discriminator字段：

components:
  schemas:
    Vehicle:
      type: object
      properties:
        vehicleProperty:
          type: string
          description: "property for vehicle"
      # 可选：多态场景添加discriminator，指定区分子类的字段
      discriminator:
        propertyName: vehicleType
        mapping:
          car: '#/components/schemas/Car'

    Car:
      type: object
      allOf:
        - $ref: '#/components/schemas/Vehicle'
      properties:
        carProperty:
          type: string
          description: "property for car"

2. 配置OpenAPI Generator启用继承模式 #

仅修改Schema还不够，需要给Generator指定继承处理模式，确保它生成真正的类继承代码：

• 命令行生成时，添加参数：

  --additional-properties=inheritanceMode=INLINE
  

• 如果用配置文件（如config.yaml），添加：

  inheritanceMode: INLINE
  

生成效果 #

修改后生成的Car类会直接继承Vehicle类，示例代码如下：

public class Car extends Vehicle implements Serializable {
    private static final long serialVersionUID = 1L;

    @JsonProperty("carProperty")
    private String carProperty;

    // 此处省略getter、setter及链式调用方法
}

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