OpenAPI 3 Schema继承的正确allOf语法是哪一种？

两种写法里，第一种是正确的，第二种存在逻辑问题，具体分析如下：

第一种写法的合理性 #

components:
  schemas:
    FileContent:
      allOf:
        - $ref: '#/components/schemas/FileInfo'
        - type: object
          properties:
            storageMethod:
              $ref: '#/components/schemas/StorageMethod'
            contentRange:
              type: string
              nullable: true
            # ... other properties ...
          additionalProperties: false

这种写法完全符合OpenAPI 3的allOf设计逻辑：通过allOf将FileInfo的基础Schema和自定义的扩展Schema组合，实现"继承基础属性+新增自定义属性"的效果。additionalProperties: false定义在扩展的Object Schema中，只会限制新增属性之外的非法字段，不会影响从FileInfo继承来的属性，完美满足Schema继承的需求。

第二种写法的问题 #

components:
  schemas:
    FileContent:
      type: object
      allOf:
        - $ref: '#/components/schemas/FileInfo'
      properties:
        storageMethod:
          $ref: '#/components/schemas/StorageMethod'
        contentRange:
          type: string
          nullable: true
        # ... other properties ...
      additionalProperties: false

这里的核心问题是additionalProperties: false作用在顶层Schema上，而顶层properties只定义了新增字段，未包含FileInfo里的属性。按照OpenAPI的规则，additionalProperties: false会拒绝所有不在当前Schema的properties列表中的字段——这就导致从FileInfo继承来的属性会被判定为"非法额外属性"，完全违背了继承的初衷。

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