python - FastAPI/Redoc 创建的“openapi.json”缺少枚举参数的“类型”键

Question

我有一个使用 FastAPI 的 REST API 构建，各种查询字符串参数都可以正常工作，生成工作openapi.json输出：

flagged: bool = False,

生成：

{
  "required": false,
  "schema": {
    "title": "Flagged",
    "type": "boolean"
  },
  "name": "flagged",
  "in": "query"
}

但是我有一些使用枚举值的参数。生成的 openAPI 定义缺少type说明符 -

sortby: TaskSortby = TaskSortby.confusion,

生成：

 {
  "required": false,
  "schema": {
    "allOf": [
      {
        "$ref": "#/components/schemas/TaskSortby"
      }
    ],
    "default": "confusion"
  },
  "name": "sortby",
  "in": "query"
}

如您所见schema.type，缺少，这会导致其他读取openapi.json文件的工具中断。

如何为 Enum 参数生成openapi.json带type键？