OpenAPI 3.0.0鉴别器代码生成失败求助：类型转换错误

你的问题出在鉴别器的定义位置错误，OpenAPI 3.0要求鉴别器必须定义在所有子 schema 共同继承的父 schema中，而不是直接放在使用oneOf的属性字段上。当前定义里，代码生成工具会自动创建CustomerReqInputIdentifier作为inputIdentifier的类型，但NumberRequest/IDRequest和这个类型没有继承关系，导致转换失败。

修正后的OpenAPI定义： #

components:
  schemas:
    # 定义公共父schema，包含鉴别器和标识字段
    CustomerReqInputIdentifier:
      type: object
      required:
        - inputType
      properties:
        inputType:
          type: string
          enum: [ID, Number]
      discriminator:
        propertyName: inputType
        mapping:
          ID: '#/components/schemas/IDRequest'
          Number: '#/components/schemas/NumberRequest'
    
    # 子schema通过allOf继承父schema
    IDRequest:
      allOf:
        - $ref: '#/components/schemas/CustomerReqInputIdentifier'
      # 这里添加IDRequest特有的属性
      properties:
        id:
          type: string
    
    NumberRequest:
      allOf:
        - $ref: '#/components/schemas/CustomerReqInputIdentifier'
      # 这里添加NumberRequest特有的属性
      properties:
        number:
          type: string
    
    wId:
      type: string # 假设wId是字符串类型，根据实际情况调整
    
    CustomerReq:
      type: object
      properties:
        inputIdentifier:
          description: Input.
          oneOf:
            - $ref: '#/components/schemas/IDRequest'
            - $ref: '#/components/schemas/NumberRequest'
        wId:
          $ref: '#/components/schemas/wId'

关键改动说明： #

• 新增CustomerReqInputIdentifier作为父 schema，包含必填的inputType枚举字段和鉴别器配置，这是代码生成工具识别多态类型的核心。
• IDRequest和NumberRequest通过allOf继承父 schema，确保它们属于CustomerReqInputIdentifier的子类型，解决类型转换问题。
• 保留CustomerReq中inputIdentifier的oneOf约束，明确允许的子类型范围。

这样调整后，代码生成工具会正确生成带有继承关系的类型，NumberRequest就能正常转换为CustomerReqInputIdentifier了。

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