Entender el contrato
Envolver un error añade contexto de la operación y conserva la causa para inspeccionarla. Usa fmt.Errorf con %w y después errors.Is para buscar un error centinela en la cadena. Así se puede reaccionar a un fallo conocido sin depender del texto mostrado a una persona.
Un centinela es un valor de error compartido que identifica una categoría. El ejemplo define ErrMissing una vez y lo envuelve con el identificador del usuario. errors.Is sigue esas relaciones. Para un error estructurado con campos, errors.As permite recuperar el tipo correspondiente.
Trabajar el ejemplo
loadUser devuelve contexto y main sigue reconociendo la ausencia de datos. El programa imprime el mensaje alternativo. Cambiar %w por %v conserva texto legible pero pierde la relación de envoltura. Usa %w cuando exponer la categoría subyacente forme parte del contrato.
package main
import (
"errors"
"fmt"
)
var ErrMissing = errors.New("missing")
func loadUser(id int) error {
return fmt.Errorf("load user %d: %w", id, ErrMissing)
}
func main() {
err := loadUser(7)
if errors.Is(err, ErrMissing) { fmt.Println("use a fallback") }
}Revisar este límite
Comparar err.Error() con una cadena se rompe al cambiar el texto o añadir contexto. Devolver errores específicos de implementación también puede exponer una dependencia a los consumidores. Decide qué categorías son estables antes de recomendar comparaciones entre paquetes.
Practicar con otra entrada
Añade otra capa y comprueba que errors.Is reconoce ErrMissing. Sustituye el centinela interior por otro error y verifica que ya no coincide.
Lección 28 de 50
Ver toda la serie Fundamentos de GoReferencias y lecturas adicionales
¿Necesitas apoyo con tu backend Go?
Colaboro con equipos de ingeniería en proyectos concretos de Go y plataformas Kubernetes, con disponibilidad limitada.
Ver servicios de consultoría Go