.net6 minimal API - OpenApiOperation Attribute does not work

描述

var app = builder.Build();
app.MapPost("/Test", Test).WithTags("MyTag");

[OpenApiOperation("MySummary", "MyDescription")]
static string Test(string foo) {
    return foo;
}

貢獻者指南

技術棧

csharprest api

領域

apidocumentationbackend

議題類型

bug

難度面向新貢獻者的預計實作難度，1 表示很小改動，5 表示專家級工作。

3

預計時間有經驗貢獻者完成調查、實作、測試並準備 pull request 的粗略時間範圍。

1-3 hours

活動狀態議題目前的可參與程度：新鮮、活躍、陳舊、阻塞或等待維護者輸入。

stale

清晰度議題是否清楚說明預期改動、驗收標準和下一步。

clear

前置要求

Familiarity with .NET 6 minimal APIsBasic understanding of NSwag and OpenAPI attributes

新手友善度1-100 的估計分數，表示該議題對首次貢獻者的友善程度。

45

研究方向

Investigate how the OpenApiOperation attribute from NSwag.Annotations is handled in the context of .NET minimal APIs. Review the NSwag source code, particularly the operation processor or filter that reads this attribute, and compare with the traditional controller based approach. Check if there are any recent commits or discussions on this issue (issue #3802) that indicate a known workaround or planned fix. The expected outcome is a minimal reproduction or a patch that makes the attribute work with app.MapPost.