我们已经将.NET更新到了10，并且也想从Swashbuckle迁移到新的集成OpenAPI生成器。

不幸的是，生成的OpenAPI规范中不再把可空枚举属性标记为可空（如 MyEnum? MyProp 或 Nullable<MyEnum> MyProp）。

使用Swashbuckle时，属性的类型是枚举类型，并且在生成的OpenAPI规范中还包含 nullable: true。现在使用新的生成器，它没有 nullable: true，而是将类型设为 oneOf，其中同时包含枚举类型和 "type": "null"。

现在在基于该规范生成API客户端时，生成的属性不再具有像 MyEnum? MyProp 那样的可空枚举类型，而是会以一个附加生成的类作为类型，如 MyEnum2 MyProp，与原始枚举类型没有联系。

如何让新的OpenAPI生成器把属性生成为可空枚举，以便客户端像以前一样拥有可空枚举属性？

解决方案

不确定默认的OpenAPI 3.1.1版本生成器的修复方法，但目前的一个变通方案是改用OpenAPI版本3.0：

options.OpenApiVersion = OpenApiSpecVersion.OpenApi3_0;