Open API Swagger 3.0中allOf未正常生成继承属性如何解决

错误原因 #

你的配置存在3个核心问题：

• 错误将allOf关键字放在properties节点下，导致生成器将引用的Student识别为普通嵌套属性，而非需要合并的父类结构
• YAML文件缩进不规范，字段层级识别错乱
• 不符合OpenAPI 3.0标准的Schema引用规则，路径不完整

正确配置示例 #

符合规范的配置如下，生成后会自动将Student的属性平铺到Address类中：

openapi: 3.0.3
info:
  title: 示例API
  version: 1.0.0
components:
  schemas:
    Student:
      type: object
      properties:
        id:
          type: integer
          format: int64
          description: The ID of the new account
        name:
          type: string
          description: The human-readable description of this account
    Address:
      type: object
      allOf:
        # 引用父类结构，合并所有属性
        - $ref: '#/components/schemas/Student'
        # 定义当前类自有属性
        - type: object
          properties:
            city:
              type: string
              description: City
            state:
              type: string
              description: State

补充说明 #

• 如果你使用的是OpenAPI Generator，可额外添加配置项"inheritance": true确保继承逻辑正常生效
• Swagger Codegen需升级到2.4.0及以上版本，老版本对allOf属性合并的支持存在缺陷

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