为什么在 Swagger 中以错误的方式显示多种类型 UI

Question

我打开了以下 api 架构：

    WaypointEntity:
      type: object
      properties:
        id:
          type: [number, "null"]

但它在 Swagger 中显示不正确 UI:

知道这是为什么吗？我是否错误地指定了类型？我正在使用 Open Api 3.0

Answer 1

在 OpenAPI 3.0 中，type 不能是类型列表，它必须是单个类型。可为空的数字定义如下：

id:
  type: number
  nullable: true   # <----

更多信息：