OpenAPI Spring代码生成器中鉴别器接口未生成共享属性方法的问题

我完全理解你现在的困扰：用OpenAPI Spring代码生成器基于带鉴别器的MainInterface生成共享类时，想把SharedProperties里的getName()和getDescription()整合到主接口中，但不管是直接加方法还是用anyOf都没达到预期——要么生成器直接忽略这些方法，要么鉴别器逻辑被搞乱，子类也没法正常继承共享属性。

下面给你几个可行的解决方案，从规范定义到生成器配置层面逐一覆盖：

方案一：在OpenAPI规范中定义共享属性（推荐） #

代码生成器的核心依据是OpenAPI规范文件（yaml/json），所以要让生成的MainInterface包含共享方法，首先得在规范里明确这些共享属性：

1. 定义共享组件Schema
   在你的OpenAPI规范的components/schemas里添加共享属性的Schema：

   components:
     schemas:
       SharedProperties:
         type: object
         properties:
           name:
             type: string
           description:
             type: string
         required:
           - name
           - description
   

2. 让主Schema继承共享属性并保留鉴别器
   修改MainInterface对应的Schema，用allOf引用共享属性，同时保留鉴别器和oneOf配置：

   MainInterface:
     type: object
     allOf:
       - $ref: '#/components/schemas/SharedProperties'
     discriminator:
       propertyName: type
       mapping:
         type1: '#/components/schemas/Type1'
         type2: '#/components/schemas/Type2'
         type3: '#/components/schemas/Type3'
     oneOf:
       - $ref: '#/components/schemas/Type1'
       - $ref: '#/components/schemas/Type2'
       - $ref: '#/components/schemas/Type3'
     required:
       - type
   

3. 简化子Schema定义
   因为子Schema已经通过oneOf关联到主Schema，而主Schema已经包含共享属性，所以子Schema只需要定义各自独有的属性即可：

   Type1:
     type: object
     properties:
       type1SpecificProp:
         type: string
   

这样生成的MainInterface会自动包含getName()和getDescription()方法，鉴别器逻辑也能正常工作，Type1/2/3类也会继承这些共享属性的实现。

方案二：调整Java接口继承关系（注解驱动场景） #

如果你是基于Java注解反向生成OpenAPI规范，或者直接用注解驱动生成器，可以调整接口的继承结构：

1. 让MainInterface继承SharedProperties
   修改你的MainInterface定义，直接继承共享属性接口：

   @Schema(
           discriminatorMapping = {
                   @DiscriminatorMapping(value = "type1", schema = Type1.class),
                   @DiscriminatorMapping(value = "type2", schema = Type2.class),
                   @DiscriminatorMapping(value = "type3", schema = Type3.class),
           },
           discriminatorProperty = "type",
           oneOf = {Type1.class, Type2.class, Type3.class}
   )
   public interface MainInterface extends SharedProperties {
           @Schema(
                   requiredMode = Schema.RequiredMode.REQUIRED,
                   example = "type1"
           )
           Type getType();
   }
   

2. 启用生成器的接口继承支持
   检查OpenAPI Generator的配置，确保开启了接口继承的生成逻辑。如果用Maven插件，可以添加如下参数：

   <plugin>
       <groupId>org.openapitools</groupId>
       <artifactId>openapi-generator-maven-plugin</artifactId>
       <configuration>
           <generateInterfaces>true</generateInterfaces>
           <interfaceOnly>true</interfaceOnly>
           <!-- 其他配置参数 -->
       </configuration>
   </plugin>
   

这样生成的MainInterface会自动包含SharedProperties的方法，同时鉴别器相关的JSON注解（@JsonTypeInfo等）也能正常生成。

方案三：自定义生成器模板（进阶） #

如果上面的方案都不满足需求，可以自定义OpenAPI Generator的Java接口模板，强制添加共享方法：

1. 找到生成器的默认Java接口模板（通常是interface.mustache）
2. 在模板中添加共享方法的定义：

   {{#interfaceMethods}}
   {{#returns}}{{{returnType}}}{{/returns}} {{name}}({{#params}}{{{dataType}}} {{name}}{{#hasMore}}, {{/hasMore}}{{/params}});
   {{/interfaceMethods}}
   <!-- 手动添加共享方法 -->
   String getName();
   String getDescription();
   

3. 在生成器配置中指定自定义模板的路径，生成的接口就会包含这些方法。

备注：内容来源于stack exchange，提问作者Pranay Tripathi