Cómo leer mensajes de error:cualquiera en 30 segundos
Cómo leer mensajes de error si tu app con IA se rompe: abre la consola del navegador, descifra la primera línea y el archivo, y arréglalo en 30 segundos.
Cómo leer mensajes de error: no estás atascado, simplemente no puedes ver el error. Cada vez que tu app creada con IA se rompe "misteriosamente", escribe en la consola del navegador una explicación exacta de lo que ha fallado. Abre la consola con un atajo de teclado, lee la primera línea y el nombre del archivo, y podrás descifrar casi cualquier error en 30 segundos, sin necesidad de ser ingeniero.
Es la habilidad de mayor palanca para un fundador no técnico que construye con IA. No porque vayas a arreglar tú todos los errores, sino porque la diferencia entre "está roto, ayuda" y pegar el error exacto en Claude es la diferencia entre una hora de conjeturas y una solución en 30 segundos.
Cómo abrir la consola del navegador
La consola es el backstage de tu web. Si tu app es una función de teatro, la consola es donde ves a los tramoyistas, las señales y el momento exacto en que algo se cae. Para abrirla:
- Chrome: Cmd + Option + J en Mac, Ctrl + Shift + J en Windows; o haz clic derecho en cualquier punto, elige Inspeccionar y pulsa la pestaña Consola
- Firefox: Cmd + Option + K en Mac, Ctrl + Shift + K en Windows
- Safari: activa primero el menú Desarrollo (Ajustes, Avanzado, "Mostrar menú Desarrollo") y luego Cmd + Option + C
Importan dos pestañas. Consola muestra errores y registros: empieza aquí siempre que algo no funcione. Red muestra cada petición que tu app hace a los servidores: úsala cuando falle el inicio de sesión o no carguen los datos: recarga la página, busca filas rojas y haz clic en una para ver los detalles. Y no, no puedes romper nada por mirar. La consola es de solo lectura por defecto.
Cómo leer mensajes de error: la anatomía de un error
Los mensajes de error intimidan porque están escritos para desarrolladores que conocen la jerga. Pero tienen una estructura fija, como un diagnóstico médico: términos técnicos, una ubicación exacta y la información suficiente para arreglar el problema. Cuatro partes, siempre en el mismo orden:
- El tipo de error. La categoría: un TypeError significa que usas algo de forma incorrecta, un ReferenceError que usas algo que no existe, un SyntaxError que el código tiene una errata, un NetworkError que la app no puede llegar a un servidor.
- La descripción. El problema concreto en una línea: "Cannot read property of undefined" significa que el código intentó usar datos que todavía no están ahí.
- La ubicación. Un nombre de archivo, un número de línea y una posición de carácter. Es la parte más útil: te dice exactamente dónde mirar.
- La pila de llamadas. La cadena de llamadas a funciones que llevó al error. Normalmente solo te interesan las primeras líneas que mencionan archivos que reconoces; el resto es código interno de librerías que puedes ignorar.
El método de 30 segundos: lee la primera línea para saber qué falló, busca el primer nombre de archivo que reconozcas para saber dónde, e ignora todo lo que mencione el interior de librerías.
Rojo, amarillo, gris: qué significan los colores
La consola codifica todo por colores según la gravedad, lo que te dice qué merece tu atención:
- Rojo = error. Algo se ha roto ahora mismo y la app no puede continuar. Para y arréglalo.
- Amarillo = advertencia. Funciona hoy, pero podría romperse más tarde o rendir mal. Arréglalo cuando puedas: las advertencias no detendrán tu app.
- Blanco o gris = información. Registros normales. Algunas librerías son simplemente habladoras. Ignóralas.
Una consola llena de mensajes no es automáticamente algo malo. Céntrate en los rojos, anota los amarillos e ignora el resto.
El libroThe Solopreneur RevolutionLuis Gonçalves sobre cómo crear un negocio de solopreneur con IA sin dejar tu empleo.Consigue el libro →Los seis errores que de verdad verás (descifrados)
Al construir un SaaS con herramientas de IA como Claude y Supabase, el mismo puñado de errores explica casi todo. Esta es la traducción a lenguaje llano:
| El error | En cristiano | Lo primero que probar |
|---|---|---|
| Cannot read property of undefined | El código usa datos que todavía no se han cargado | Añade una comprobación de carga antes de usar los datos |
| 401 Unauthorized | No has iniciado sesión, o tu sesión ha caducado | Cierra sesión, vuelve a entrar e inténtalo de nuevo |
| 403 Forbidden | Has iniciado sesión pero no tienes permiso | Revisa tu rol y las políticas de seguridad de la base de datos |
| 404 Not Found | La página o el endpoint no existe | Comprueba la ortografía de la URL; confirma que la ruta existe |
| Network request failed | La app no puede hablar con el servidor en absoluto | Confirma que el servidor de desarrollo está en marcha y que los ajustes de URL son correctos |
| Row violates security policy | La capa de seguridad de la base de datos bloquea la operación | Comprueba que estás autenticado y que la política permite esta acción |
Los códigos de estado siguen una sola regla: todo lo que esté en los 200 significa éxito, los 400 significan que hiciste algo mal (datos erróneos, sin sesión, sin permiso, dirección equivocada) y los 500 significan que se rompió el propio servidor. Esa única regla descifra toda la pestaña Red.
Qué pegar cuando pides ayuda a la IA
Aquí es donde leer errores compensa. Cuando le das un error a Claude, la calidad de la respuesta depende de lo que pegues. Tres cosas, siempre:
- El mensaje de error completo, incluido el nombre del archivo y el número de línea, copiado directamente de la consola (clic derecho en el mensaje, Copiar)
- El código alrededor del error: unas cinco líneas antes y después de la línea a la que apunta el error
- Lo que estabas haciendo: una frase: "Intentaba cargar la página de perfil después de iniciar sesión"
Con esas tres cosas, la IA arregla la mayoría de los errores al primer intento. Sin ellas, adivina, y una IA que adivina es como acabas en el lío descrito en las señales de que la IA se equivoca con seguridad. Si el mismo error sigue volviendo, o estás atascado en un escenario y no en un error concreto, el siguiente artículo repasa los diez problemas más comunes al construir con IA y sus soluciones.
Los errores no son el enemigo. Son la app diciéndote exactamente lo que necesita. Los fundadores que lanzan no son los que nunca ven texto rojo, sino los que dejaron de tenerle miedo.
12 semanasTu carrera corporativa nunca fue el planSolicita plaza en el Solopreneur Accelerator.Solicitar ahora →Preguntas frecuentes
¿Necesito entender de código para leer mensajes de error?
No. Necesitas reconocer las cuatro partes (tipo, descripción, ubicación, pila de llamadas) y copiarlas con precisión. El tipo de error y la descripción se parecen mucho al lenguaje llano una vez que has visto los más comunes, y la ubicación es solo un nombre de archivo y un número de línea. La IA hace el resto.
¿Puedo romper mi app usando la consola del navegador?
No. Las herramientas de desarrollo son de solo lectura por defecto: miras entre bastidores, no recolocas el decorado. Puedes abrir la consola, moverte por las pestañas y copiar mensajes sin ningún riesgo para tu app ni tus datos.
¿Qué errores debo arreglar primero?
Los errores rojos que bloquean flujos esenciales: errores de red, de autenticación, de base de datos y todo lo que produzca una pantalla en blanco. Las advertencias amarillas pueden esperar. Los registros grises de información no requieren ninguna acción: son solo la app narrando su día.
¿Y si la consola no muestra errores pero la app sigue fallando?
Revisa la pestaña Red en busca de filas rojas: una petición fallida no siempre lanza un error visible en la consola. Si la red también está limpia, probablemente los datos se están filtrando en lugar de fallar: cuenta equivocada, registros inactivos o una marca de borrador. Ese escenario y otros nueve están descifrados en la guía de problemas comunes al construir con IA.
¿Hasta qué punto estás atrapado?
Haz el Índice de Asfixia Corporativa, la evaluación gratuita para saber si estás listo para ser solopreneur.