如何在.NET Minimal API中绑定所有路由与请求方法到同一处理器？

你可以通过以下方式在Minimal API中实现类似IHttpHandler或NodeJS的全局请求处理模式，将所有路由和HTTP方法绑定到同一个处理逻辑，手动控制请求响应和路由：

核心实现方案 #

利用Minimal API的Map方法搭配通配符路由/{**path}匹配所有请求路径，再通过HttpMethodMetadata指定支持的所有HTTP方法，即可将所有请求导向同一个处理方法，直接操作HttpContext完成手动路由和请求处理。

示例1：内联委托处理所有请求 #

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

// 绑定所有路径、所有HTTP方法到同一处理逻辑
app.Map("/{**path}", async (HttpContext context) =>
{
    var request = context.Request;
    var response = context.Response;

    response.ContentType = "text/html";
    switch (request.Method.ToUpper())
    {
        case "GET":
            await response.WriteAsync("This is a get");
            break;
        case "POST":
            await response.WriteAsync("This is a post");
            break;
        default:
            response.StatusCode = StatusCodes.Status405MethodNotAllowed;
            await response.WriteAsync("Method not allowed");
            break;
    }
})
// 指定支持的所有HTTP方法
.WithMetadata(new HttpMethodMetadata(new[] { "GET", "POST", "PUT", "DELETE", "PATCH", "HEAD" }));

app.Run();

示例2：抽离独立方法（贴近IHttpHandler模式） #

如果希望和原有ProcessRequest的结构更接近，可以将处理逻辑抽成独立方法：

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

// 独立处理方法，对应原IHttpHandler的ProcessRequest
async Task ProcessAllRequests(HttpContext context)
{
    var request = context.Request;
    var response = context.Response;

    // 手动路由逻辑
    if (request.Path.StartsWithSegments("/legacy-api"))
    {
        response.ContentType = "text/plain";
        switch (request.Method)
        {
            case "GET":
                await response.WriteAsync($"GET request to {request.Path}");
                break;
            case "POST":
                var requestBody = await new StreamReader(request.Body).ReadToEndAsync();
                await response.WriteAsync($"POST request received: {requestBody}");
                break;
            // 其他方法处理逻辑
        }
    }
    else
    {
        response.StatusCode = StatusCodes.Status404NotFound;
        await response.WriteAsync("Resource not found");
    }
}

// 绑定所有请求到该方法
app.Map("/{**path}", ProcessAllRequests)
.WithMetadata(new HttpMethodMetadata(
    new[] { HttpMethod.Get.Method, HttpMethod.Post.Method, HttpMethod.Put.Method, HttpMethod.Delete.Method }));

app.Run();

关键注意事项 #

• 异步处理：.NET Core推荐使用异步API（如WriteAsync替代同步Write），避免阻塞线程池。
• HttpContext兼容性：.NET Core的HttpContext与.NET Framework中IHttpHandler的HttpContextAPI大部分兼容，核心属性（请求方法、路径、响应输出等）均可直接复用原有逻辑。
• 方法覆盖：HttpMethodMetadata需列出所有需要支持的HTTP方法，确保不会出现405方法不允许的错误。

内容的提问来源于stack exchange，提问作者Tom Sawyer