.net Core Global Exception Handler

5 min read Jun 03, 2024

Gestionnaire d'exceptions global dans ASP.NET Core

ASP.NET Core fournit un moyen flexible et puissant de gérer les exceptions qui surviennent dans votre application. Plutôt que de laisser les exceptions non gérées entraîner des erreurs 500 et des expériences utilisateur frustrantes, vous pouvez utiliser un gestionnaire d'exceptions global pour contrôler la manière dont les erreurs sont traitées et affichées.

Pourquoi utiliser un gestionnaire d'exceptions global ?

Amélioration de la robustesse de l'application: Un gestionnaire d'exceptions global vous permet de gérer les erreurs de manière centralisée, garantissant que toutes les exceptions sont traitées de manière cohérente.
Gestion des erreurs personnalisée: Vous pouvez personnaliser la réponse aux erreurs, en fonction du type d'exception, de l'environnement d'exécution (développement ou production) et d'autres facteurs.
Amélioration de l'expérience utilisateur: Vous pouvez fournir des messages d'erreur clairs et concis aux utilisateurs, en les guidant vers les actions appropriées.
Enregistrement et surveillance: Vous pouvez enregistrer les exceptions pour déboguer et analyser les problèmes, ce qui vous permet d'identifier les tendances et de résoudre les erreurs plus rapidement.

Mise en œuvre d'un gestionnaire d'exceptions global

Vous pouvez implémenter un gestionnaire d'exceptions global dans ASP.NET Core en utilisant l'interface IExceptionFilter ou l'attribut [ExceptionHandler]. Voici un exemple utilisant l'interface IExceptionFilter :

public class GlobalExceptionHandler : IExceptionFilter
{
    private readonly ILogger _logger;

    public GlobalExceptionHandler(ILogger logger)
    {
        _logger = logger;
    }

    public void OnException(ExceptionContext context)
    {
        // Enregistrement de l'exception
        _logger.LogError(context.Exception, "Une exception s'est produite.");

        // Définition du code d'état HTTP
        context.HttpContext.Response.StatusCode = 500;

        // Définition du contenu de la réponse
        context.Result = new ContentResult
        {
            Content = "Une erreur s'est produite. Veuillez réessayer plus tard.",
            StatusCode = 500
        };
    }
}

Dans cet exemple, le gestionnaire d'exceptions global enregistre l'exception, définit le code d'état HTTP à 500 et renvoie un message d'erreur simple à l'utilisateur.

Configuration du gestionnaire d'exceptions

Pour configurer le gestionnaire d'exceptions global, vous devez l'ajouter à la chaîne de services dans le fichier Startup.cs :

public void ConfigureServices(IServiceCollection services)
{
    // ...
    services.AddScoped();
    // ...
}

En utilisant la méthode AddScoped, le gestionnaire d'exceptions sera créé une fois par requête.

Points importants à retenir

Le gestionnaire d'exceptions global est exécuté pour toutes les exceptions non gérées dans votre application.
Vous pouvez utiliser l'objet ExceptionContext pour accéder à des informations sur l'exception, la requête et la réponse.
Assurez-vous de gérer les exceptions de manière appropriée pour maintenir la sécurité et la stabilité de votre application.

Conclusion

Un gestionnaire d'exceptions global est un outil essentiel pour la création d'applications ASP.NET Core robustes et faciles à déboguer. En utilisant un gestionnaire d'exceptions global, vous pouvez gérer les erreurs de manière centralisée, améliorer l'expérience utilisateur et garantir la fiabilité de votre application.