如何使用openapi-generator-maven-plugin实现无discriminator的继承

OpenAPI 2.0 规范原生的多态继承设计确实依赖discriminator字段做运行时类型识别，所以官方默认的代码生成逻辑默认绑定了这个必填字段要求。以下是无需discriminator即可生成正确继承关系的可行方案：

openapi-generator 原生支持非标准的Vendor扩展字段来声明继承关系，完全不需要配置discriminator，也不会破坏required字段的解析逻辑：

• 父类Schema不需要额外配置
• 子类Schema直接添加x-extends扩展指定父类即可，示例：

"Parent": {
  "type": "object",
  "required": ["parentField1"],
  "properties": {
    "parentField1": {"type": "string"},
    "parentField2": {"type": "integer"}
  }
},
"Child": {
  "type": "object",
  "x-extends": "#/components/schemas/Parent",
  "required": ["childField1"],
  "properties": {
    "childField1": {"type": "string"},
    "childField2": {"type": "boolean"}
  }
}

这种写法下，生成的Java类会自动让Child继承Parent，且父类、子类的required字段都会被正确识别，对应校验注解也会正常生成。

如果你不想用Vendor扩展，坚持用allOf写法，可以在maven插件配置中添加以下参数，解决required字段失效的问题：

<plugin>
  <groupId>org.openapitools</groupId>
  <artifactId>openapi-generator-maven-plugin</artifactId>
  <version>${openapi-generator.version}</version>
  <executions>
    <execution>
      <goals>
        <goal>generate</goal>
      </goals>
      <configuration>
        <inputSpec>${project.basedir}/src/main/resources/openapi.yaml</inputSpec>
        <generatorName>java</generatorName>
        <configOptions>
          <!-- 把allOf结构识别为继承关系 -->
          <allOfAsInheritance>true</allOfAsInheritance>
          <!-- 关闭discriminator强制要求 -->
          <disableDiscriminator>true</disableDiscriminator>
          <!-- 合并allOf各块的required字段 -->
          <mergeAllOfAttributes>true</mergeAllOfAttributes>
        </configOptions>
      </configuration>
    </execution>
  </executions>
</plugin>

添加配置后，你之前使用的allOf引用父类的写法就能正常识别父类+子类的所有required字段，不会再被忽略。

• 以上方案仅针对openapi-generator生效，原版swagger-codegen对无discriminator继承的支持较差，建议优先切换到openapi-generator
• 如果需要生成多态序列化/反序列化逻辑，依然建议使用discriminator字段，否则运行时JSON序列化框架无法自动识别子类类型

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