Tratando erros com o IExceptionHandler no .NET 8

À medida que as aplicações se tornam cada vez mais complexas e interconectadas, a necessidade de lidar com falhas de forma eficiente e resiliente se torna crucial. Com isso, o .NET 8 introduziu uma ferramenta poderosa para lidar com exceções de maneira mais granular e personalizada: o IExceptionHandler.

O IExceptionHandler é uma interface que permite que os desenvolvedores personalizem o tratamento de exceções em suas aplicações. Ele fornece um mecanismo para interceptar exceções não tratadas em diferentes partes de uma aplicação e tomar medidas específicas para lidar com elas. Esta interface pode ser implementada para direcionar exceções para logs, relatórios de erros, notificações ao usuário, ou qualquer outra ação adequada para o contexto da aplicação.

Neste post, vamos explorar o IExceptionHandler, como ele pode ser implementado e os benefícios que ele traz para a resiliência de nossas aplicações.

Pré-requisitos

• Visual Studio 2022 (.NET 8.0)
• Nuget packages: 
  • Serilog.AspNetCore
  • Serilog.Exceptions
  • Serilog.Sinks.Async

Implementando o IExceptionHandler

O primeiro passo é criar uma classe que implementa a interface IExceptionHandler, conforme o exemplo abaixo:

Em seguida, vamos configurar a classe Program.cs:

Sempre que houver uma exceção em nossa aplicação, o ErrorHandlingMiddleware será invocado automaticamente. A API também gerará o ProblemDetails. E por fim, é registrado o middleware com UseExceptionHandler. Dessa forma, temos mais controle sobre como interceptamos, tratamos e formatamos respostas de erro.

Benefícios

1. Centralização do Tratamento de Exceções: Com o IExceptionHandler, podemos centralizar a lógica de tratamento de exceções em um único local, facilitando a manutenção e a consistência do código.
2. Personalização do Tratamento de Exceções: A interface oferece flexibilidade para personalizar o tratamento de exceções de acordo com as necessidades específicas de cada aplicação, permitindo a implementação de lógica específica para diferentes tipos de exceção ou cenários.
3. Melhoria na Visibilidade e Diagnóstico de Erros: Ao integrar o IExceptionHandler com mecanismos de logging, relatórios de erros ou sistemas de monitoramento, podemos obter uma visão mais clara e detalhada das exceções que ocorrem em nossa aplicação, facilitando a identificação e a resolução de problemas.

Finalizando

O IExceptionHandler é uma ferramenta poderosa para aumentar a resiliência e a confiabilidade de aplicações com o .NET 8, oferecendo uma maneira flexível e personalizada de lidar com exceções não tratadas. Ao implementar e integrar esta interface em nossas aplicações, podemos melhorar significativamente a experiência do usuário e a qualidade do software, garantindo que ele seja capaz de lidar eficientemente com situações de erros inesperadas.

Os detalhes completos deste exemplo você encontra no meu GitHub: https://github.com/hgmauri/sample-iexceptionhandler e neste post.