Resumen de Puntos Clave sobre Manejo de Errores

Cada viñeta destacada de las 9 páginas de esta sección, reunida en una sola página y agrupada por la página de origen.

Errores como Valores: La Filosofía de Errores de Go

• Los errores son valores ordinarios devueltos junto con los resultados
• Los llamadores manejan fallos en el punto de uso, no en bloques catch distantes
• El envoltorio preserva las cadenas de causas sin desenrollado de pila oculto
• Las bibliotecas exponen contratos de error mínimos; las aplicaciones añaden contexto en los límites
• Panic es para errores de programador, no para fallos esperados de I/O o validación

Conceptos Básicos de Manejo de Errores

• Las funciones devuelven (T, error) donde un error nil señala éxito
• Usa fmt.Errorf con %w para envolver errores preservando las cadenas
• Comprueba los errores inmediatamente y retorna pronto, evitando ifs anidados
• Usa errors.Is para comparar errores centinela a través de cadenas de unwrap
• La limpieza diferida se ejecuta en todas las rutas de código, incluso con retornos de error
• Escribe mensajes de error accionables que describan qué falló y por qué

Errores Centinela y errors.Is

• Los centinelas son valores estables var ErrX = errors.New(...)
• errors.Is recorre las cadenas de unwrap; == se rompe después de envolver
• Exporta solo los errores que son parte de tu contrato público
• Prefiere pocos centinelas; usa tipos personalizados cuando necesites campos
• io.EOF es flujo de control, no siempre un fallo grave

Envoltorio de Errores con %w y errors.As

• %w en fmt.Errorf preserva las cadenas de unwrap para Is y As
• errors.As encuentra el primer tipo asignable en la cadena
• Usa %v en los límites cuando los errores internos deban permanecer ocultos
• errors.Unwrap expone un nivel; Is/As recorren la cadena completa
• errors.Join agrega múltiples fallos de trabajo paralelo

Tipos de Errores Personalizados e Interfaces de Error

• Los tipos struct contienen campos que los llamadores extraen con errors.As
• Mantén las superficies de error exportadas pequeñas y estables
• Las interfaces opcionales (Timeout, Temporary) permiten comprobaciones de comportamiento
• Los receptores de valor evitan errores de interfaz nil tipados
• Las cadenas Error() son para humanos; los campos son para lógica

Trazas de Pila con runtime/debug

• debug.Stack captura la pila de goroutines actual en la creación del error
• Adjunta pilas en capas de aplicación, no en bibliotecas de bajo nivel
• Las pilas son para operadores, no para clientes de API
• Empareja con slog o logging estructurado en el límite
• runtime/debug es ligero en comparación con las trazas completas de panic

Manejo de Errores en Código Concurrente

• Las goroutines no pueden devolver errores a su padre; usa canales o errgroup
• errgroup cancela el trabajo hermano ante el primer fallo
• Selecciona en errCh y ctx.Done() para un apagado limpio
• errors.Join agrega múltiples fallos de validación
• Nunca ignores errores de goroutines sin un plan de entrega

Diseño de Errores de API para Servicios HTTP y gRPC

• Los errores de dominio permanecen agnósticos al transporte hasta el manejador o interceptor
• HTTP usa JSON de problema estable; gRPC usa códigos de estado y detalles
• Mapea con errors.Is y errors.As, no con coincidencia de cadenas
• Nunca filtres detalles del driver o de la pila a los clientes
• Registra el contexto interno en el servidor con IDs de solicitud

Mejores Prácticas de Manejo de Errores

• Las bibliotecas devuelven errores; las aplicaciones registran y mapean en los límites
• Envuelve con %w para contexto; usa Is/As para lógica
• Exporta contratos de error pequeños y estables
• Nunca filtres internos en respuestas HTTP o gRPC
• Prueba las rutas de error con errors.Is y errors.As

Y29kZWd1aWRlcy5pb3xjZ2lvNDg0fDIwMjYwNw==