3 · Infraestructura·3 min de lectura

Perseguí la caché tres veces; era una línea

31 ago 2026InfraestructuraMétodoDepuración

"Es la caché" es la explicación más cómoda y la que más tiempo cuesta.

Una funcionalidad nueva estaba desplegada —compilaba, TypeScript no se quejaba, el despliegue decía éxito— y no aparecía en pantalla. La primera hipótesis fue la de siempre. Recarga forzada. Nada. Se sospechó del borde de la red, del servidor, del navegador.

La prueba que costó diez segundos#

Antes de purgar nada a ciegas: abrir la página en una ventana privada. Sin caché de por medio, sin extensiones, sin sesión.

Tampoco apareció. No era caché. No había nada que limpiar.

Lo que era#

Una lista en el código decidía qué elementos se pintan. El módulo nuevo existía, compilaba y se desplegaba — y no estaba en esa lista. Un filtro lo escondía.

Es una familia de fallas que el compilador no ve. TypeScript verifica tipos, no que un módulo esté enlazado desde el menú, ni que una clase CSS siga existiendo después de un renombre global, ni que un rótulo apunte a algo real. Un módulo que no está en el menú no existe, aunque el código sea perfecto.

Qué hicimos#

Dos cosas. La primera, de método: antes de arreglar, aislar — una prueba barata que elimine la hipótesis cómoda, y solo entonces buscar.

La segunda, para que no se repita: verificar contra la pantalla, no contra el despliegue. Que el build pase no significa que se vea. Si se declaró un valor y en pantalla hay otro, no es cuestión de magnitud: el selector no está aplicando ahí, y subirle el número no lo va a arreglar. Se mide la captura antes de volver a tocar el código.

Lo que nos llevamos#

"Es la caché" pospone el diagnóstico en vez de hacerlo. Diez segundos en una ventana privada evitaron una tarde de purgas inútiles — y el hábito de desconfiar de la explicación fácil vale más que cualquier herramienta.