ASP.NET Core MVC客户端中止请求时未处理TaskCancelledException问题咨询

同步、异步实现表现不一致的原因 #

• 同步Action中执行Thread.Sleep时，ASP.NET Core没有机制主动中断运行中的同步托管线程，客户端断开后服务端仍会继续执行完代码，自然不会抛出取消相关异常
• 异步Action中传入的CancellationToken绑定了HttpContext.RequestAborted，客户端断开时令牌会立刻触发取消信号，所有监听该令牌的异步操作都会抛出TaskCanceledException，如果Action内没有捕获该异常，就会冒泡到Kestrel层被记录为Error级别日志

正确处理方式 #

1. 局部捕获（精准控制，推荐优先使用） #

只在对应Action内捕获和请求取消关联的异常，不影响其他业务场景的取消异常上报：

[HttpGet("Delay")]
public async Task<IActionResult> GetDelayAsync(CancellationToken cancellationToken)
{
    try
    {
        await Task.Delay(30_000, cancellationToken);
        return Ok();
    }
    catch (OperationCanceledException) when (cancellationToken.IsCancellationRequested)
    {
        // 明确是客户端主动取消导致的异常，直接返回204即可，异常不会向上冒泡
        return NoContent();
    }
}

这里通过when过滤器做判断，只有当前传入的绑定了请求取消的令牌触发时才捕获，其他场景抛出的OperationCanceledException（比如内部业务逻辑自定义的取消令牌触发）会继续正常抛出，不会被误吞。

2. 全局统一处理（适合不想逐个Action修改的场景） #

通过自定义异常中间件全局处理，统一判断异常是不是客户端断开引发的：

中间件实现示例：

public class ClientAbortExceptionMiddleware : IMiddleware
{
    private readonly ILogger<ClientAbortExceptionMiddleware> _logger;

    public ClientAbortExceptionMiddleware(ILogger<ClientAbortExceptionMiddleware> logger)
    {
        _logger = logger;
    }

    public async Task InvokeAsync(HttpContext context, RequestDelegate next)
    {
        try
        {
            await next(context);
        }
        catch (OperationCanceledException) when (context.RequestAborted.IsCancellationRequested)
        {
            // 客户端主动断开，不需要记录错误日志，也不需要返回响应
            _logger.LogDebug("客户端主动中止请求，请求ID：{RequestId}", context.TraceIdentifier);
        }
    }
}

然后在Program.cs里把中间件注册到管道最前面即可：

app.UseMiddleware<ClientAbortExceptionMiddleware>();

补充说明 #

ASP.NET Core官方默认不吸收该异常的原因是框架无法自动区分TaskCanceledException是客户端取消导致的，还是业务逻辑主动抛出的异常，所以默认全部向上抛出交由开发者自行处理，避免误吞业务异常。

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