OpenAPI 3.0.2中additionalProperties: false规则不生效问题求助

核心问题 #

你定义的abc是object类型，但实际请求里abc是数组（array）——类型不匹配导致原有的additionalProperties: false等校验规则完全没触发。校验器会因为顶层类型不符，跳过对数组内部对象的校验，自然不会检测到额外属性。

修正后的OpenAPI配置 #

把abc的类型改为array，并通过items字段定义数组内每个对象的校验规则：

abc:
  type: array
  items:
    type: object
    additionalProperties: false
    required:
      - something
      - id
    properties:
      something:
        $ref: '#/xyz'
      id:
        description: id.
        type: string
        minLength: 1
        maxLength: 100

为什么之前的调整无效 #

• 调整配置层级但没修正abc的类型为array，规则始终作用在object上，和实际请求的数组不匹配。
• unevaluatedProperties: false需要作用在正确的对象层级，且前提是顶层类型匹配，否则无法触发校验。

额外注意 #

部分校验工具默认不开启严格类型校验，需确保工具启用了严格模式，才能检测到顶层类型不匹配的问题。

内容的提问来源于stack exchange，提问作者nezuko-chan