Checklist de depuración para fundadores:orden de 5 min

Un checklist de depuración: cuando algo se rompa, comprueba las cosas en este orden exacto: recarga la página, lee la consola, confirma que has iniciado sesión, confirma que la app está realmente en marcha y confirma que guardaste los cambios. Esas cinco comprobaciones llevan cinco minutos y resuelven el 90 % de los problemas. El orden es el método: la mayoría de los fundadores depura adivinando al azar, y por eso se quedan atascados.

Depurar es una habilidad, no magia. Aquí tienes el checklist completo, desde la comprobación rápida de cinco minutos hasta la opción nuclear.

Checklist de depuración, paso 1: la comprobación rápida de 5 minutos (90 % de los problemas)

1. Recarga la página. Borra el estado temporal y vuelve a cargar tus datos. Si una recarga normal no ayuda, haz una recarga forzada (mantén Shift mientras recargas), que también borra los archivos en caché que tu navegador puede estar sirviendo desde la semana pasada.
2. Abre la consola y busca rojo. La consola de desarrollador del navegador es donde los errores se anuncian. El texto en rojo es un error, y el mensaje suele nombrar el archivo y la línea. Si parece jeroglífico, cómo leer mensajes de error descifra los patrones.
3. ¿Has iniciado sesión? La mayoría de funciones exigen autenticación y las sesiones caducan en silencio. Busca tu información de usuario en la cabecera; ante la duda, cierra sesión y vuelve a entrar. Una porción asombrosa de funciones «rotas» es solo un inicio de sesión caducado.
4. ¿Está la app realmente en marcha? Si trabajas en local, mira el terminal: tu servidor de desarrollo debería estar imprimiendo registros. Si se cayó o nunca se arrancó, nada funcionará, y ninguna cantidad de mirar el código lo arreglará.
5. ¿Guardaste el archivo? Los cambios sin guardar no se ejecutan. Busca el punto junto al nombre del archivo en tu editor. Sí, a esto le pasa a todo el mundo.

La mayoría de los errores son así de simples: sesión no iniciada, olvidar guardar, servidor sin arrancar, una errata, olvidar recargar. Empieza por lo simple: no está por debajo de ti, es estadística.

La comprobación profunda de 15 minutos

Si la comprobación rápida no lo encontró, baja una capa, siempre en orden y de una cosa en una:

• Borra la caché del navegador. Los archivos antiguos en caché pueden chocar con el código nuevo. Una recarga forzada suele bastar.
• Abre la pestaña Network (Red). En las mismas herramientas de desarrollador, la pestaña Network muestra cada petición que hace tu app. Recarga la página y busca filas rojas (peticiones fallidas) y lee sus códigos de estado (tabla abajo).
• ¿Se aplicaron de verdad los cambios en tu base de datos? Si cambiaste hace poco la estructura de la base de datos, confirma que el cambio se ejecutó: una tabla o columna que falta rompe todo lo que la toca. Revisa el panel de tu base de datos para ver la tabla que esperas.
• Revisa tu archivo de configuración. Las apps leen secretos y direcciones de un archivo de entorno. Valores que faltan, una clave equivocada o espacios de más rompen todo, y tras cambiarlo debes reiniciar la app para que lo note.
• Sospecha de tu cambio más reciente. Si funcionaba hace una hora, lo que hayas cambiado desde entonces es el principal sospechoso. Deshaz o comenta temporalmente el cambio más nuevo y mira si el problema desaparece.

Lo que te dice la pestaña Network

Esas cuatro filas convierten la pestaña más temida del navegador en una enfermera de triaje: te dicen si el problema es tu sesión, tu dirección o tu código.

El libroThe Solopreneur RevolutionLuis Gonçalves sobre cómo crear un negocio de solopreneur con IA sin dejar tu empleo.Consigue el libro →

La opción nuclear

Cuando nada más funciona, existe la versión del desarrollador de «apágalo y vuelve a encenderlo»: detén la app, borra las dependencias instaladas, reinstálalas desde cero, borra la caché del navegador y reinicia. Suena tosco, pero arregla de forma fiable instalaciones corruptas, dependencias desactualizadas y esa categoría exasperante de «en el ordenador de mi amigo funciona y en el mío no».

Úsala la última, no la primera, porque arregla las cosas sin decirte qué fallaba, y la próxima vez estarás igual de atascado.

Las tres reglas que hacen que el checklist funcione

Cambia una cosa a la vez. Si cambias cinco cosas y empieza a funcionar, no sabes qué lo arregló, lo que significa que tampoco sabes qué lo rompió.

Prueba después de cada cambio. No acumules arreglos. Haz un cambio, comprueba, sigue.

Documenta lo que funcionó. Los mismos errores se repiten. Un archivo de notas de «síntoma → solución» se convierte en tu herramienta de depuración más rápida en un mes.

Y cuando el checklist se agote: escala con criterio, no con desesperación. Pásale el error a tu asistente de IA con los prompts de depuración con IA, o redacta un informe de error en condiciones siguiendo cómo pedir ayuda técnica. Para entonces ya sabrás responder qué estabas haciendo, qué esperabas, qué pasó y qué has probado, que es justo lo que el checklist te acaba de hacer reunir.

12 semanasTu carrera corporativa nunca fue el planSolicita plaza en el Solopreneur Accelerator.Solicitar ahora →

Preguntas frecuentes

¿Qué debo comprobar primero cuando mi app se rompe?

Recarga la página y luego lee la consola. Esos dos pasos llevan menos de un minuto y resuelven por sí solos una gran parte de los problemas. Después confirma que has iniciado sesión, que la app está en marcha y que tus cambios están guardados. Solo después de esos cinco debes empezar a leer código.

¿Por qué importa depurar en un orden fijo?

Porque adivinar al azar cambia varias cosas a la vez, así que nunca aprendes qué fallaba de verdad. Un orden fijo prueba primero las causas más probables y más baratas de comprobar y las va descartando una a una, lo que es más rápido de media y, de regalo, te enseña los patrones de fallo de tu sistema.

Mis cambios no aparecen: ¿qué pasa?

Por orden de probabilidad: no guardaste el archivo, la app no está en marcha, tu navegador muestra una versión en caché (recarga forzada) o estás editando un archivo distinto del que usa la app. Las cuatro son comprobaciones de dos minutos, y entre todas cubren casi todos los casos.

¿Cuándo debo dejar de depurar y pedir ayuda?

Tras la comprobación rápida y la profunda: unos 20 minutos de trabajo sistemático. Para entonces ya puedes decir qué estabas haciendo, qué esperabas, qué pasó, el error exacto y qué has probado. Eso es todo lo que necesita una buena petición de ayuda, se la pidas a una IA o a una persona.