OpenAPI Generator生成的Java客户端与Spring服务端模型不兼容问题

1. 修正OpenAPI规范的多态定义 #

确保Section的items数组直接引用带discriminator的基类SectionItemBase，而非直接用oneOf列出子类。这样生成器会统一以基类作为数组元素类型，避免生成独立的SectionItemsInner类。

示例规范片段：

components:
  schemas:
    SectionItemBase:
      type: object
      discriminator:
        propertyName: type
        mapping:
          SectionItemInput: '#/components/schemas/SectionItemInput'
          SectionItemOutput: '#/components/schemas/SectionItemOutput'
      required:
        - type
      properties:
        type:
          type: string
    SectionItemInput:
      allOf:
        - $ref: '#/components/schemas/SectionItemBase'
      properties:
        name:
          type: string
        input:
          type: string
    SectionItemOutput:
      allOf:
        - $ref: '#/components/schemas/SectionItemBase'
      properties:
        name:
          type: string
        output:
          type: string
    Section:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/SectionItemBase' # 直接引用基类

2. 调整客户端生成器配置 #

如果必须保留oneOf定义，在maven插件配置中添加以下参数，强制生成器将oneOf类型转为接口，与服务端结构对齐：

<plugin>
  <groupId>org.openapitools</groupId>
  <artifactId>openapi-generator-maven-plugin</artifactId>
  <version>6.2.1</version>
  <executions>
    <execution>
      <goals>
        <goal>generate</goal>
      </goals>
      <configuration>
        <generatorName>java</generatorName>
        <library>webclient</library>
        <!-- 其他配置：spec路径、输出目录等 -->
        <configOptions>
          <!-- 启用oneOf类型转为接口 -->
          <oneOfModelsToInterfaces>true</oneOfModelsToInterfaces>
          <!-- 启用多态反序列化支持 -->
          <enablePolymorphicDeserialization>true</enablePolymorphicDeserialization>
          <!-- 确保子类继承基类 -->
          <inheritanceDiscriminatorEnabled>true</inheritanceDiscriminatorEnabled>
        </configOptions>
      </configuration>
    </execution>
  </executions>
</plugin>

3. 手动修正生成的客户端模型（临时方案） #

如果上述方法无法生效，可手动修改生成的代码：

• 将SectionItemsInner改为继承SectionItemBase的接口
• 让SectionItemInput、SectionItemOutput实现该接口

示例修改代码：

// 修改后SectionItemsInner
public interface SectionItemsInner extends SectionItemBase {
}

// 确保子类实现该接口
public class SectionItemInput extends SectionItemBase implements SectionItemsInner {
  // 原有代码
}

public class SectionItemOutput extends SectionItemBase implements SectionItemsInner {
  // 原有代码
}

同时调整Section类中items的类型为List<SectionItemsInner>，确保Jackson多态解析注解配置正确。

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