Error 500: lo que me ha enseñado gestionar servidores durante años
El error HTTP 500, oficialmente llamado "500 Internal Server Error", es un código de estado que el servidor envía cuando encuentra una condición inesperada que le impide completar tu petición. Piensa en él como un "no sé qué ha pasado, pero algo va mal aquí dentro". A diferencia de un 404 que te dice claramente "no encuentro esa página", el 500 es el cajón de sastre de los errores: el servidor sabe que ha fallado, pero no logra mapear la causa a un código más específico.
Durante mis años dirigiendo infraestructura web en operadores de telecomunicaciones, lo primero que aprendí sobre este fallo es que nunca es culpa del visitante. No importa cuántas veces reinicies el router, cambies de navegador o limpies el caché. El problema está en el otro lado, en la infraestructura o en el código de la web que intentas cargar. Y eso es importante repetirlo, porque veo a mucha gente perder media tarde tocando ajustes de su equipo ante un 500 que jamás se resolverá desde su extremo.
Los códigos HTTP son el lenguaje del servidor con el cliente. La familia "5xx" indica que el servidor sabe que ha fallado. Dentro de esa familia, el 500 se devuelve únicamente cuando ningún otro código (502 Bad Gateway, 503 Service Unavailable, 504 Gateway Timeout) resulta aplicable. Es decir, es el último recurso antes de admitir derrota.
Lo confuso es que la forma en que aparece en pantalla cambia radicalmente según el servidor. Apache suele soltar un texto plano: "Internal Server Error. The server encountered an internal error or misconfiguration...". Nginx es más seco: un simple "500 Internal Server Error". Microsoft IIS añade substatus codes que acotan la causa, como el 500.19 (configuración inválida) o el 500.13 (servidor saturado). Google incluso lo disfrazó durante años con su famoso "500. That's an error.". Y si la web usa una CDN o un proxy inverso, la página de error puede provenir del intermediario, no del origen, lo que complica aún más identificar la capa culpable.
| Servidor | Mensaje típico |
|---|---|
| Apache | Texto plano con descripción genérica |
| Nginx | "500 Internal Server Error" escueto |
| IIS | Añade substatus (500.19, 500.13, etc.) |
| "500. That's an error." | |
| ASP.NET | "Is currently unable to handle this request. HTTP ERROR 500" |
En WordPress, por ejemplo, unas credenciales erróneas en DB_NAME, DB_USER, DB_PASSWORD o DB_HOST del archivo wp-config.php son un disparador clásico. Y un .htaccess corrupto con una directiva mal escrita basta para tumbar un directorio entero. He visto proyectos caer por un punto y coma de más.
Las causas más frecuentes se resumen en: base de datos caída o lenta, permisos incorrectos sobre archivos, errores de configuración en php.ini o nginx.conf, excepciones no controladas en el código (una división por cero, una llave sin cerrar), dependencias incompatibles entre plugins o librerías, y saturación de recursos como memoria PHP o espacio en disco agotado. En un hosting compartido, el límite de memoria es especialmente traicionero: un script que supera el memory_limit aborta con un fatal error que muchas configuraciones presentan simplemente como un 500.
“Si el 500 aparece tras enviar un pago o formulario, NO recargues. La transacción puede haberse completado aunque la respuesta falló.”
Dato clave