Manipulação abrangente de exceção no ASP.Net Core Web Apis

Este artigo aborda os desafios de lidar com as exceções de maneira confiável originária de todos os filtros, incluindo filtros de autorização, dentro da APIs da Web do ASP.NET Core. As diferenças entre o manuseio de exceções no núcleo do ASP.NET e da API da Web ASP.NET clássica são significativas, geralmente causando confusão para os desenvolvedores que fazem a transição.

abordando as limitações dos filtros de exceção tradicionais

Embora os filtros de exceção no ASP.NET Core possam lidar com exceções de ação, eles historicamente lutam para capturar exceções lançadas em outros filtros, como filtros de autorização. Essa limitação requer uma abordagem mais robusta.

a solução iExceptionHandler (asp.net Core 8 e mais tarde)

asp.net Core 8 e as versões posteriores apresentam a interface iExceptionHandler , fornecendo uma solução poderosa e flexível. iExceptionHandler permite:

• injeção de dependência (por exemplo, para registro).
• manuseio personalizado com base em tipos de exceção específicos.
• manuseio de exceção consistente entre ações e todos os tipos de filtro.

implementando iExceptionHandler:

1. Crie um iexceptionHandler implementação:

using Microsoft.AspNetCore.Diagnostics;

public class MyExceptionHandler : IExceptionHandler
{
    public async ValueTask TryHandleAsync(HttpContext context, Exception exception, CancellationToken cancellationToken)
    {
        // Implement your exception handling logic here.  This could include logging,
        // returning a custom error response, etc.
        return true; // Return true to indicate the exception was handled.
    }
}

2. Registre o ExceptionHandler Middleware:

builder.Services.AddExceptionHandler();
app.UseExceptionHandler(_ => { });

Considerações -chave:

• Ordem de registro: múltiplo iexceptionHandler implementações podem ser registradas. Eles serão executados sequencialmente na ordem do registro.
• TryHandLeasync Return Valor: retornando true de TryHandLeasync sinais de que a exceção foi tratada. A false o valor de retorno passa a exceção aos manipuladores subsequentes.

Este método garante um tratamento abrangente de exceção em sua API da Web ASP.NET Core, abordando as limitações das abordagens anteriores.