Swagger无法处理Null类型：可选枚举参数UI及代码生成问题求解

问题描述 #

• 定义可选枚举类型的查询参数时，Swagger UI不再显示下拉选项；同时Swagger（TypeScript）代码生成器无法处理Null类型，多数生成器遇到可空类型会转为any。
• Pydantic 2对可选类型的要求与Pydantic 1不同，必须显式设置可选类型。
• 近期FastAPI版本将OpenAPI从3.0.4升级至3.1.0，但支持3.1.0的库数量极少，尤其是Null类型未被任何库支持。

代码示例：

• 必填参数（Swagger UI正常显示下拉）：type: CategoryType | Query()
• 可选参数（Swagger UI不显示下拉）：type: CategoryType | None = Query(default=None)

已尝试方案 #

• 不降级FastAPI的前提下降低OpenAPI版本→不可行
• 不降级FastAPI的前提下降级至Pydantic 1→存在依赖冲突，不可行
• 更换不同代码生成器并升级Swagger UI→未找到有效解决方案
• 在FastAPI官方社区发起相关讨论

求助 #

求解决上述问题的方案，也欢迎提供临时变通办法。

内容的提问来源于stack exchange，提问作者Tobias Ernst