为何ASP.NET Core Minimal API端点会等待Task完成？

在构建基础ASP.NET Core Minimal API时，我发现一个意外情况：若端点返回Task，请求要等到Task完成才会响应。代码示例如下：

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddSingleton<ICounterService, CounterService>();

var app = builder.Build();

app.MapGet("/counter/value", (ICounterService counter) => counter.Value);
app.MapGet("/counter/incrementnow", (ICounterService counter) => counter.Increment());
app.MapGet("/counter/incrementlater", (ICounterService counter) => Task.Delay(TimeSpan.FromSeconds(5)).ContinueWith(_ => counter.Increment()));
app.MapGet("/counter/incrementlaternowait", (ICounterService counter) => { Task.Delay(TimeSpan.FromSeconds(5)).ContinueWith(_ => counter.Increment()); return; });

app.Run();

interface ICounterService
{
    int Value { get; }
    void Increment();
}

class CounterService : ICounterService
{
    public int Value { get; private set; }

    public void Increment()
    {
        int previousValue = Value++;
        Console.WriteLine($"Incremented from {previousValue} to {Value}.");
    }
}

我原本以为只有在async端点中显式await Task时才会出现此行为，请问该行为的相关文档在哪里？

回答 #

ASP.NET Core的端点处理逻辑中，无论是否显式使用async/await修饰端点委托，只要端点返回Task或Task<T>类型，框架都会自动等待该任务完成后再发送响应。这是框架内置的异步处理机制，目的是确保异步操作的完成状态（或结果）能正确衔接请求响应流程，避免请求上下文提前结束引发的资源泄漏或逻辑错误。

相关说明主要存在于官方文档的Minimal API 返回类型处理章节，其中明确规定：当端点返回Task时，框架会异步等待任务完成；返回Task<T>时，会等待任务完成后将结果作为响应内容。这种设计完全符合ASP.NET Core请求处理管道的规范——所有关联请求的异步任务都需要被妥善等待，防止后台任务未完成就释放请求相关资源。

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