GlobalErrorHandler.Middleware 1.0.0

GlobalErrorHandler.Middleware

Un middleware liviano y reutilizable para el manejo global de errores en aplicaciones .NET, compatible con .NET Standard 2.0.

📋 Características

• ✅ Compatible con .NET Standard 2.0
• 🚀 Fácil integración mediante métodos de extensión
• ⚙️ Altamente configurable
• 🎯 Mapeo automático de excepciones a códigos HTTP
• 📝 Logging integrado
• 🔍 Soporte para diferentes entornos (Development/Production)
• 🔒 Manejo seguro de errores sensibles
• 📦 Respuestas JSON consistentes

📥 Instalación

Package Manager Console

Install-Package GlobalErrorHandler.Middleware

.NET CLI

dotnet add package GlobalErrorHandler.Middleware

🚀 Uso Básico

using GlobalErrorHandler.Middleware;

public class Program
{
    public static void Main(string[] args)
    {
        var builder = WebApplication.CreateBuilder(args);
        var app = builder.Build();

        // Agregar el middleware de manejo de errores
        app.UseGlobalErrorHandler(new GlobalErrorHandlerOptions 
        {
            DefaultErrorMessage = "Ha ocurrido un error inesperado",
            WriteIndentedJson = true
        });

        // ... resto de la configuración
    }
}

⚙️ Configuración

Opciones Disponibles

Ejemplo de Configuración Completa

app.UseGlobalErrorHandler(new GlobalErrorHandlerOptions 
{
    DefaultErrorMessage = "Oops! Algo salió mal",
    WriteIndentedJson = true
});

📝 Formato de Respuesta

Las respuestas de error siguen esta estructura:

{
    "httpResponse": 500,
    "message": "Descripción del error",
    "result": null
}

🎯 Mapeo de Excepciones

📚 Ejemplos de Uso

Manejo de Excepciones Básicas

[ApiController]
[Route("[controller]")]
public class ProductsController : ControllerBase
{
    [HttpGet]
    public IActionResult Get()
    {
        throw new ArgumentException("ID de producto inválido");
        // Respuesta:
        // Status: 400
        // {
        //   "httpResponse": 400,
        //   "message": "ID de producto inválido",
        //   "result": null
        // }
    }
}

Errores No Controlados

[HttpPost]
public IActionResult Create()
{
    throw new Exception("Error interno al crear el producto");
    // En desarrollo:
    // Status: 500
    // {
    //   "httpResponse": 500,
    //   "message": "Error interno al crear el producto - [StackTrace]",
    //   "result": null
    // }
    
    // En producción:
    // Status: 500
    // {
    //   "httpResponse": 500,
    //   "message": "Ha ocurrido un error inesperado",
    //   "result": null
    // }
}

📋 Requerimientos

• .NET Standard 2.0 o superior
• ASP.NET Core 2.1 o superior

📦 Dependencias

• Microsoft.AspNetCore.Hosting.Abstractions (>= 2.1.0)
• Microsoft.Extensions.Logging.Abstractions (>= 2.1.0)
• Microsoft.AspNetCore.Http.Abstractions (>= 2.1.0)
• Newtonsoft.Json (>= 13.0.1)

✅ Mejores Prácticas

1. Orden del Middleware: Coloca el middleware al principio del pipeline para capturar todas las excepciones.

if (app.Environment.IsDevelopment())
{
    app.UseDeveloperExceptionPage();
}

app.UseGlobalErrorHandler(); // Primero
app.UseRouting();           // Después
app.UseAuthentication();    // ...
app.UseAuthorization();     // ...

2. Configuración por Ambiente:

app.UseGlobalErrorHandler(new GlobalErrorHandlerOptions 
{
    DefaultErrorMessage = app.Environment.IsDevelopment() 
        ? "Error en desarrollo" 
        : "Error en producción"
});

📄 Licencia

Este proyecto está bajo la licencia MIT - ver el archivo LICENSE.md para más detalles.