Errores HTTP comunes y cómo solucionarlos

Los errores HTTP son los mensajes que tu servidor envía cuando algo no va bien. Entender qué significa cada código es el primer paso para solucionar problemas rápidamente. En esta guía cubrimos los errores más comunes, sus causas y soluciones.

Anatomía de un código de error HTTP

Los códigos HTTP tienen 3 dígitos. El primero indica la categoría:

• 1xx: Informativos (raro verlos)
• 2xx: Éxito (200 OK es el más común)
• 3xx: Redirecciones
• 4xx: Errores del cliente (el problema está en la petición)
• 5xx: Errores del servidor (el problema está en el servidor)

Errores 4xx: Problemas del cliente

Error 400 - Bad Request

Qué significa: El servidor no entiende la petición por sintaxis incorrecta.

Causas comunes:

• URL malformada
• Cookies corruptas
• Caché del navegador corrupta
• Archivo subido demasiado grande

Soluciones:

• Verifica la URL
• Limpia cookies y caché del navegador
• Revisa límites de upload en php.ini

Error 401 - Unauthorized

Qué significa: Se requiere autenticación para acceder al recurso.

Causas comunes:

• Credenciales incorrectas
• Sesión expirada
• Token de autenticación inválido

Soluciones:

• Verifica usuario y contraseña
• Renueva la sesión/token
• Revisa la configuración de autenticación del servidor

Error 403 - Forbidden

Qué significa: El servidor entiende la petición pero se niega a autorizarla.

Causas comunes:

• Permisos de archivo incorrectos
• Reglas de .htaccess bloqueando acceso
• IP bloqueada por firewall
• Directorio sin archivo index

Soluciones:

• Verifica permisos: 644 para archivos, 755 para carpetas
• Revisa reglas de .htaccess
• Comprueba si tu IP está bloqueada
• Añade DirectoryIndex o desactiva listado de directorios

Error 404 - Not Found

Qué significa: El recurso solicitado no existe en el servidor.

Causas comunes:

• URL incorrecta o con typo
• Página eliminada o movida
• Enlace roto
• Problema de rewrite rules

Soluciones:

• Verifica que la URL es correcta
• Implementa redirecciones 301 para páginas movidas
• Crea una página 404 personalizada útil
• Usa herramientas para detectar enlaces rotos

Error 429 - Too Many Requests

Qué significa: Has enviado demasiadas peticiones en poco tiempo (rate limiting).

Causas comunes:

• Demasiadas peticiones a una API
• Bot o crawler agresivo
• Ataque detectado por el WAF

Soluciones:

• Espera antes de reintentar
• Implementa backoff exponencial en tu código
• Contacta al administrador si es un bloqueo erróneo

Errores 5xx: Problemas del servidor

Error 500 - Internal Server Error

Qué significa: Error genérico del servidor. Algo falló pero no se especifica qué.

Causas comunes:

• Error de sintaxis en PHP
• Permisos incorrectos
• .htaccess corrupto o con errores
• Plugin o tema defectuoso (WordPress)
• Límite de memoria excedido

Soluciones:

1. Revisa el archivo error_log del servidor
2. Verifica permisos de archivos
3. Renombra .htaccess temporalmente
4. Desactiva plugins uno por uno (WordPress)
5. Aumenta memory_limit en php.ini

Si ves este error, consulta nuestra guía completa sobre qué hacer cuando tu web se cae.

Error 502 - Bad Gateway

Qué significa: El servidor actuando como proxy recibió una respuesta inválida del servidor upstream.

Causas comunes:

• Servidor backend caído
• PHP-FPM no responde
• Timeout en la comunicación entre servidores
• Firewall bloqueando conexiones internas

Soluciones:

• Reinicia PHP-FPM: sudo systemctl restart php-fpm
• Verifica que el backend está corriendo
• Aumenta timeouts en la configuración del proxy
• Revisa logs de Nginx/Apache y PHP-FPM

Error 503 - Service Unavailable

Qué significa: El servidor no puede manejar la petición temporalmente.

Causas comunes:

• Servidor sobrecargado
• Mantenimiento programado
• Límite de conexiones alcanzado
• Ataque DDoS en curso

Soluciones:

• Espera y reintenta (puede ser temporal)
• Escala recursos del servidor
• Implementa caché para reducir carga
• Activa protección DDoS

Error 504 - Gateway Timeout

Qué significa: El servidor proxy no recibió respuesta a tiempo del servidor upstream.

Causas comunes:

• Script PHP muy lento
• Consulta de base de datos pesada
• Servidor backend sobrecargado
• Problemas de red entre servidores

Soluciones:

• Optimiza consultas de base de datos
• Aumenta max_execution_time en PHP
• Aumenta proxy_read_timeout en Nginx
• Revisa el tiempo de respuesta del servidor

Error 520-530 - Errores de Cloudflare

Si usas Cloudflare, puedes ver errores específicos:

• 520: Respuesta vacía o inesperada del origen
• 521: El servidor web está caído
• 522: Timeout de conexión al origen
• 523: Origen inalcanzable
• 524: Timeout de respuesta

Cómo monitorear errores HTTP

No esperes a que los usuarios te reporten errores. Configura monitoreo proactivo:

Monitoreo de uptime

Con WatcherWolf recibes alertas inmediatas cuando tu web devuelve errores 5xx. Configura alertas inteligentes para reaccionar rápidamente.

Análisis de logs

Revisa regularmente los logs de tu servidor para detectar patrones de errores antes de que se conviertan en problemas mayores.

Herramientas de diagnóstico

Herramientas como Google Search Console te alertan de errores 4xx que afectan al SEO, mientras que New Relic o Sentry te ayudan a rastrear errores 5xx en aplicaciones.

Checklist de diagnóstico rápido

Conclusión

Entender los códigos de error HTTP te permite diagnosticar y solucionar problemas más rápido. Los errores 4xx generalmente requieren correcciones en la petición o configuración del servidor, mientras que los 5xx indican problemas que requieren atención inmediata en el servidor.

Configura monitoreo proactivo para detectar errores antes que tus usuarios. Con WatcherWolf puedes monitorear tu web 24/7 y recibir alertas instantáneas cuando algo falla.

Empieza a monitorear errores HTTP gratis