swagger-ui 不显示 400 的响应模型

Question

这是我生成的 swagger 文档的摘录。

    "responses": {
      "200": {
        "description": "successful operation",
        "schema": {
          "$ref": "#/definitions/ActionJsValue"
        }
      },
      "400": {
        "description": "list of validation errors",
        "schema": {
          "type": "array",
          "items": {
            "$ref": "#/definitions/Error"
          }
        }
      }
    }

在定义部分:

"Error": {
  "type": "object",
  "properties": {
    "path": {
      "type": "string"
    },
    "messages": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
},

并且 swagger-ui 不显示响应模型。

有人遇到过这个问题吗？
任何人都知道如何解决这个问题？

Answer 1

我遇到了完全相同的问题，并找到了下一个解决方法。

方法说明:

"responses": {
  "200": {
    "description": "successful operation",
    "schema": {
      "$ref": "#/definitions/ActionJsValue"
    }
  },
  "400": {
    "description": "list of validation errors",
    "schema": {
      "$ref": "#/definitions/ErrorsArray"
    }
  }
}

定义部分:

"ErrorsArray": {
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "path": {
        "type": "string"
      },
      "messages": {
        "type": "array",
        "items": {
          "type": "string"
        }
      }
    }
  }
}

因此，只需将您的数组定义为单独的类型。