OpenApiVersion 預設為 OpenApi3_2

的 OpenApiVersion 預設值已從 OpenApiSpecVersion.OpenApi3_1 變為 OpenApiSpecVersion.OpenApi3_2。 依賴 OpenAPI 3.1 輸出且未明確設定版本的應用程式,現在會產生 OpenAPI 3.2 文件。

所推出的版本

.NET 11 預覽版 6

以前的行為

先前,OpenApiOptions.OpenApiVersion 的預設值為 OpenApiSpecVersion.OpenApi3_1。 若呼叫 AddOpenApi 時未明確設定版本,則產生 OpenAPI 3.1 文件。

新行為

從 ASP.NET Core 11 預覽版 6 開始,OpenApiOptions.OpenApiVersion預設為 OpenApiSpecVersion.OpenApi3_2。 現在若呼叫 AddOpenApi 時未明確設定版本,會產生 OpenAPI 3.2 文件。

破壞性變更的類型

此變更為行為變更。

變更原因

ASP.NET Core 的 OpenAPI 支援以最新版本的 OpenAPI 規範作為預設,讓應用程式能在不需額外設定的情況下享受新功能。

大多數情況下,不需要採取行動。 為了支援尚未支援 OpenAPI 3.2 的下游工具,請明確設定版本:

builder.Services.AddOpenApi(options =>
{
    options.OpenApiVersion = Microsoft.OpenApi.OpenApiSpecVersion.OpenApi3_1;
});

受影響的 API