Error 500, 502, 503 y 504: qué significan y cómo solucionarlos

Un error 500 significa que el servidor de tu sitio tuvo una falla interna: recibió la petición del visitante, intentó procesarla y algo tronó de su lado. Sus primos son variaciones del mismo drama: el 502 es un intermediario que no obtuvo respuesta válida de tu servidor, el 503 es un servicio saturado o en mantenimiento, y el 504 es una espera que se agotó. Todos pertenecen a la familia 5xx, los errores del lado del servidor, así que el problema (y la solución) está en tu cancha, no en la del visitante. Aquí te explico qué hay detrás de cada código, cómo solucionarlo y cómo enterarte en cuanto aparece, no cuando un cliente te reclame.

La oficina de trámites: los errores del servidor sin dolor

Piensa en la última vez que hiciste un trámite. Llegaste temprano, hiciste tu fila, llevaste todos tus papeles. Y cuando por fin te tocó ventanilla, la persona del otro lado te soltó la frase nacional: "fíjese que se cayó el sistema".

Tu sitio web funciona igual que esa oficina. Cada visitante llega a la ventanilla con una solicitud: quiere ver tu página principal, agregar algo al carrito, pagar. Si trae mal los papeles (pide una página que no existe, por ejemplo), el error es suyo: esa es la familia 4xx, donde vive el famoso 404. Pero cuando los papeles están en orden y aun así el trámite no sale, la falla es de la oficina. Esa es la familia 5xx, y estos son sus cuatro integrantes más conocidos:

Vamos uno por uno.

Error 500: se cayó el sistema

El error 500 (Internal Server Error) es el más genérico de todos: el servidor sabe que algo salió mal, pero no sabe (o no quiere) decir qué. Es la ventanilla encogiéndose de hombros.

Las causas más comunes, en orden de sospecha:

• Lo último que cambiaste. Un deploy reciente, un plugin o tema que actualizaste (clásico en WordPress), una dependencia nueva. Si el error apareció hoy, piensa en qué tocaste ayer.
• Un archivo de configuración roto. Un .htaccess con una línea de más puede tumbar el sitio completo.
• La base de datos no responde. El código está bien, pero no tiene con quién hablar.
• Memoria agotada. Común en hosting compartido: tu sitio creció y el plan no.

¿Cómo se arregla? Revisa los logs de tu servidor (ahí casi siempre está la respuesta con nombre y apellido), revierte el último cambio, desactiva el plugin más reciente o pregúntale a tu hosting si algo cambió de su lado. La regla de oro: el error 500 casi nunca aparece solo; algo lo invitó.

Error 502: la recepción no encuentra a nadie

Entre tu visitante y tu servidor casi siempre hay un intermediario: un proxy como nginx, un CDN como Cloudflare, el balanceador de tu hosting. El error 502 (Bad Gateway) significa que ese intermediario está vivo y trabajando, pero cuando fue a buscar la respuesta a la oficina de atrás, no encontró a nadie: tu aplicación se murió, se está reiniciando o contestó algo que no se entiende.

Qué checar:

• ¿Tu aplicación sigue viva? Un proceso que truena y no se reinicia solo es la causa número uno.
• ¿Acabas de hacer deploy? Muchos 502 duran exactamente lo que tarda tu app en reiniciar.
• ¿Es tu hosting o tu CDN? Revisa su página de estado antes de perseguir fantasmas en tu código.

Error 503: vuelva más tarde

El error 503 (Service Unavailable) es la oficina con el letrero de "regresamos en 15 minutos". El servidor está ahí, pero no puede atender: o está saturado o está en mantenimiento.

Es el único de la familia que a veces es intencional: muchos sitios responden 503 a propósito mientras instalan una actualización. El problema es cuando no fue a propósito:

• Tu campaña funcionó demasiado bien. El tráfico del Buen Fin, una mención viral, y el servidor que aguantaba 100 visitas recibe 10,000.
• El modo mantenimiento se quedó prendido. Actualizaste, todo salió bien, y nadie quitó el letrero.
• Recursos agotados. En hosting compartido, a veces el vecino de servidor hace fiesta y pagas tú.

Las soluciones van desde poner una capa de caché o CDN (para que no todas las visitas lleguen hasta tu servidor) hasta subir de plan de hosting antes de tu próxima campaña fuerte.

Error 504: la espera que nadie aguanta

El error 504 (Gateway Timeout) es primo del 502, pero con otra historia: el intermediario sí encontró a tu servidor, le pasó la solicitud y se cansó de esperar la respuesta. Tu servidor no está muerto: está lento, que para el visitante es exactamente lo mismo.

Los sospechosos de siempre:

• Una consulta lenta a la base de datos. Esa búsqueda que tarda 40 segundos desde que la tabla creció.
• Un servicio externo que tarda. Tu pasarela de pago o una API de terceros anda lenta, y tu sitio paga los platos rotos.
• Un servidor que ya no da. El plan que contrataste hace tres años ya no aguanta el sitio de hoy.

La solución de fondo es encontrar qué está lento (los logs y las herramientas de tu hosting ayudan), optimizar esa consulta o subir los recursos.

Cómo enterarte de un error 500 antes que tus clientes

Aquí viene la parte incómoda: los errores 5xx no avisan. No llegan en horario de oficina ni esperan a que estés viendo tu sitio. Aparecen a las 2 de la mañana, en pleno pico de tráfico, o justo cuando arrancó la campaña que llevabas un mes preparando. Y si tienes una tienda en línea, cada minuto de error es un carrito abandonado: échale un ojo a lo que el monitoreo hace por un ecommerce si vives del checkout.

La salida es no depender de la suerte: un servicio de monitoreo visita tu sitio cada tanto, como un visitante de verdad, y si tu servidor responde con un error 500, 502, 503 o 504, lo marca como caído y te avisa de inmediato. OhSnap, por ejemplo, revisa tu sitio hasta cada 30 segundos y antes de alertarte hace una doble verificación, para que un parpadeo de la red no te despierte por nada. Las alertas llegan por correo, SMS y, en el plan Unlimited, por WhatsApp, Slack o Telegram: todos los canales están explicados en la página de alertas.

Y mientras arreglas el problema, una página de estado pública le cuenta a tus usuarios qué está pasando, para que tu soporte no se llene de "¿está caído?".

Empieza antes del próximo susto

No necesitas presupuesto para dejar de enterarte por accidente: el plan gratuito de OhSnap incluye 5 monitores con revisiones cada 5 minutos y alertas por correo y SMS sin gastar un peso. Los errores del servidor van a llegar tarde o temprano; hasta a los sitios más grandes se les cae el sistema de vez en cuando. La diferencia entre un susto y una crisis es quién se entera primero. Que eso de "se cayó el sistema" no te lo tenga que contar un cliente.