如何让无指定HTTP方法的Minimal API接口在Swagger UI中显示？

你的推测没错，Swagger（基于OpenAPI规范）默认只会识别绑定了明确HTTP方法的接口——因为OpenAPI要求每个接口操作必须关联至少一个HTTP方法。而你用app.Map不指定方法时，虽然接口本身支持所有HTTP方法，但Swagger不会自动识别这种隐式绑定。

不过完全可以让这个接口出现在Swagger UI和JSON里，有两种简单方法：

方法一：显式声明支持所有HTTP方法 #

在你的接口配置后加上AcceptsAllMethods()方法，直接告诉Swagger这个接口接受所有标准HTTP方法：

app.Map("Hello/{*rest}", (HttpRequest request, string rest) => $"Hello, World! Request: {request.Method} -> {rest}")
   .WithName("Hello")
   .AcceptsAllMethods();

这个方法会自动把GET、POST、PUT、DELETE、PATCH、HEAD、OPTIONS这些方法关联到接口上，Swagger就能正常识别并展示它了。

如果需要更精细的控制（比如只支持部分方法），也可以用WithMethods()逐个指定：

.WithMethods("GET", "POST", "PUT", "DELETE")

方法二：手动添加到OpenAPI文档（进阶） #

如果第一种方法不满足需求，可以通过自定义IOperationFilter手动把这个接口添加到Swagger文档中。比如在配置SwaggerGen时：

builder.Services.AddSwaggerGen(options =>
{
    options.OperationFilter<AllMethodsOperationFilter>();
});

public class AllMethodsOperationFilter : IOperationFilter
{
    public void Apply(OpenApiOperation operation, OperationFilterContext context)
    {
        // 通过接口名称判断是否为目标接口
        if (context.ApiDescription.ActionDescriptor.DisplayName == "Hello")
        {
            context.ApiDescription.SupportedHttpMethods.Clear();
            // 添加需要支持的所有HTTP方法
            context.ApiDescription.SupportedHttpMethods.AddRange(new[] {
                HttpMethod.Get, HttpMethod.Post, HttpMethod.Put, HttpMethod.Delete,
                HttpMethod.Patch, HttpMethod.Head, HttpMethod.Options
            });
            operation.Responses.Add("200", new OpenApiResponse { Description = "请求成功" });
        }
    }
}

这种方式更灵活，但一般第一种方法就足够解决问题。

处理后，你的网关接口就能正常出现在Swagger UI的方法列表和Swagger JSON中，不用再纠结它“隐身”的问题。

内容的提问来源于stack exchange，提问作者Wim ten Brink