Un mensaje de error no es una fatalidad: es una frase, y casi siempre designa al responsable. Solo hay que saber quién habla — el navegador, el servidor, o su aplicación.
Quién habla
| Quién | En qué reconocerlo | Lo que implica |
|---|---|---|
| El navegador | Mensaje en el idioma del navegador, con su propia apariencia | La petición no llegó al servidor, o no entera |
| El servidor | Un código de tres cifras, una página sobria | La petición llegó; la respuesta es un rechazo o un fallo |
| Su aplicación | El mensaje lleva la apariencia de su sitio | El servidor trabajó bien; es el sitio el que falló |
La tabla de códigos
| Código | Lo que dice el servidor | Causa más frecuente | Lo que puede hacer |
|---|---|---|---|
| 301 / 302 | Ya no está aquí, vaya allí | Una redirección deseada | Nada: no es un error |
| 401 | Identifíquese | Una zona protegida por contraseña | Comprobar las credenciales |
| 403 | Me niego | Permisos de fichero, o carpeta sin página de inicio | Comprobar los permisos y el fichero índice |
| 404 | No tengo esa página | Enlace muerto, dirección cambiada, fichero ausente | Comprobar la dirección, luego los enlaces internos |
| 429 | Demasiadas peticiones | Un robot, un script en bucle, un ataque | Señalarlo, y mirar quién llama |
| 500 | Mi aplicación falló | Extensión, actualización, error de código | Anular la última modificación, leer el registro |
| 502 / 504 | No tuve respuesta a tiempo | Una página que tarda demasiado en construirse | Aligerar la página, señalarlo si persiste |
| 503 | No estoy disponible | Mantenimiento, o sobrecarga momentánea | Reintentar, luego señalarlo si dura |
Los mensajes que no llevan código
- Página enteramente blanca — la aplicación se interrumpió escondiendo su error. El registro del sitio dice más en una línea que la página en una hora.
- «Error de conexión a la base de datos» — el sitio ya no alcanza su base: credenciales modificadas en el fichero de configuración, o base ausente.
- «Servidor no encontrado» / «No se puede acceder a este sitio» — el nombre de dominio no conduce a ninguna parte. Nada que ver con el contenido del sitio.
- «Su conexión no es privada» — el certificado falta, no cubre esta dirección, o el reloj de su equipo está desajustado.
El registro de errores
Si su aplicación lleva un registro, dice en una línea lo que una página blanca esconde por completo: el fichero culpable y el número de línea. Es el primer lugar donde mirar para todo error 500.
Si no sabe dónde encontrarlo para su alojamiento, pídanoslo en un ticket: le indicaremos la ruta exacta para su servicio.
No deje nunca la visualización de errores activada en un sitio en línea. Un mensaje de error detallado muestra al público rutas de ficheros y a veces credenciales. Se lee en el registro, no en la página.
Lo que debe transmitirnos
El código, la dirección exacta de la página, la hora, y la línea del registro si la tiene. Con esos cuatro elementos, una incidencia se trata en una respuesta.