.NET 7 Minimal API异步静态方法返回结果异常问题排查

我在.NET 7中创建了如下Minimal API：

app.MapPost("/test", SomeEndpoint.Test);

使用同步静态方法时可正常运行：

public static class SomeEndpoint
{
    public static IResult Test(HttpContext httpContext)
    {
        var form = httpContext.Request.ReadFormAsync().Result;
        return Results.Ok(form);
    }
}

但将方法改为异步形式后：

public static class SomeEndpoint
{
    public static async Task<IResult> Test(HttpContext httpContext)
    {
        var form = await httpContext.Request.ReadFormAsync();
        return Results.Ok(form);
    }
}

无论返回Results.Ok还是Results.BadRequest，始终得到200 OK响应，请问哪里操作错误？

问题原因及解决方法 #

这是因为端点映射时未正确识别异步方法的返回类型。当方法返回Task<IResult>时，若框架无法正确推断该异步签名，会默认将其视为返回void的异步方法，直接返回200 OK，忽略你实际返回的IResult实例。

解决方式 #

1. 显式指定泛型参数
   修改端点映射代码，明确告知框架返回类型：

app.MapPost<IResult>("/test", SomeEndpoint.Test);

2. 使用异步委托包装
   通过委托让框架自动识别异步签名：

app.MapPost("/test", async (HttpContext httpContext) => await SomeEndpoint.Test(httpContext));

3. 优化方法参数（推荐）
   利用Minimal API的自动绑定特性，直接绑定表单对象，既简化代码又避免类型推断问题：

public static class SomeEndpoint
{
    public static async Task<IResult> Test(IFormCollection form)
    {
        // 示例校验逻辑
        if (string.IsNullOrEmpty(form["key"]))
        {
            return Results.BadRequest("缺少必要参数");
        }
        return Results.Ok(form);
    }
}

// 映射时直接使用，框架自动处理绑定和异步类型识别
app.MapPost("/test", SomeEndpoint.Test);

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