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.

Referencias 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