Contextos Go sin dolor: cómo entender context.Context y por qué está en todas partes

Los desarrolladores de Go se acostumbran rápidamente a la sintaxis: funciones, interfaces, errores. Pero casi inmediatamente después de «Hello, world», algo misterioso comienza a aparecer en el código: context.Context. Y no solo en algún lugar de las profundidades del paquete, sino directamente en la firma de cada segunda función. ¿Por qué es necesario y por qué no se puede prescindir de él?

Veámoslo.

¿Qué es el contexto en Go?

context.Context es un objeto especial que se transmite a través de la cadena de llamadas y gestiona:

• tiempo de vida de las operaciones,

• cancelación de procesos,

• plazos,

• transferencia de metadatos (por ejemplo, ID de solicitud).

El contexto es como una "mochila invisible" que la función recibe junto con la llamada y de la que se puede obtener información útil.

Dónde se encuentra el contexto con más frecuencia

1. Trabajar con consultas de red — cancelación por tiempo de espera, si la respuesta tarda demasiado en llegar.

2. Consultas a la base de datos — para no mantener la conexión "colgada" indefinidamente.

3. Fuego de fondo — graceful shutdown al finalizar el servicio.

¿Por qué está en casi todos los argumentos?

Go se adhiere al principio: lo explícito es mejor que lo implícito. En lugar de variables globales o señales ocultas, las funciones reciben contexto directamente. Esto hace que el código sea predecible y proporciona control en el nivel superior, desde donde comienza la solicitud.

func fetchUser(ctx context.Context, id int) (User, error) {
    row := db.QueryRowContext(ctx, "SELECT name FROM users WHERE id=?", id)
    ...
}

Si la solicitud se establece ctx con tiempo de espera, cualquier operación dentro se detendrá automáticamente después de que se agote el tiempo.

Técnicas de trabajo importantes

Creación de contexto con tiempo de espera:

ctx, cancel := context.WithTimeout(context.Background(), 2*time.Second)
defer cancel()

Cancelación manual:

ctx, cancel := context.WithCancel(context.Background())
go func() {
    time.Sleep(time.Second)
    cancel() // detendremos el trabajo de todos los que escuchan este ctx
}()

Transmisión de valores (¡con cuidado!):

ctx = context.WithValue(ctx, "requestID", "abc123")

Importante: no vale la pena abusar de WithValue: son más bien "metadatos" que datos completos.

Errores y trampas típicos

• No se ha llamado a cancel() → pérdida de recursos.

• Metemos todo en WithValue → se pierde la legibilidad.

• No transmitimos el contexto → privamos a la función de la capacidad de controlarse a sí misma.

La idea principal de context es simple: el control debe estar en el código de llamada, no en el código llamado. Es por eso que en Go casi todas las funciones públicas del paquete de biblioteca estándar comienzan con el argumento ctx.

El contexto no es solo una palabra de moda en Go. Es una herramienta integrada que hace que tus programas sean predecibles, manejables y estén protegidos contra bloqueos. Cuanto antes empieces a usarlo correctamente, menos «dolor» tendrás en el futuro.

Kodika tiene nuevo curso de Go de alta calidad 🚀
Este es un comienzo potente y comprensible para aquellos que quieren dominar el lenguaje en el que se escriben servicios rápidos y fiables. En el curso explicamos todo con palabras sencillas: desde los primeros pasos hasta conceptos serios como las gorutinas y los contextos.

Y también tenemos un acogedor canal de telegram, donde compartimos noticias del mundo de TI, analizamos tareas interesantes y nos comunicamos con la comunidad. Suscríbete para no perderte lo más importante.