Enums 枚举对swagger文档的支持

Swagger对OpenAPI3.0的enum支持让我有点困惑。我在这里的观点是，在swagger文档中有了新的改进，它支持可重用的枚举 此处记录：

其中使用$ref表示对可重用枚举的支持。然而，当我将swagger.json发布到swagger编辑器/验证器时，如下所示

in: query
          name: prop-name
          description: something
          type: array
          items:
            $ref: '#/definitions/mytype'

具体定义如下：

mytype:
    enum:
      - Item1
    type: string

Swagger editor抛出一个错误，并表示

不应具有其他属性
附加属性：$ref

现在，加载swagger页面并获得功能时，这不是一个问题，但在使用swagger gen并使用它生成客户端时，这是一个问题。swagger gen CLI也抛出了相同的错误，导致我们现在无法正确生成此页面的客户端

---

这个swagger.json有什么问题吗？我可以提供任何额外的信息来阐明这个问题吗？

在OpenAPI 2.0中，数组参数模式不能使用

$ref

。您必须定义

枚举

内联：

-in:query
名称：道具名称
描述：什么
类型：数组
项目：
类型：字符串
枚举：
-项目1

您使用的是

斯威格：“2.0”还是
openapi:3.0.0
？我使用的是斯威格2.0