# Códigos de error HTTP en KapsuleHost Source: https://support.kapsulehost.com/es-es/http-error-codes Lo que realmente significan 403, 404, 500, 502, 503 y 504 en esta plataforma, y qué hacer exactamente en cada caso. Un código de error no es un mensaje de fallo genérico. Indica qué capa de la infraestructura falló, y eso reduce enormemente la causa. Un 502 y un 504 parecen idénticos para un visitante, pero tienen causas y soluciones completamente distintas. ## Leer el código real Antes de solucionar el problema, obtenga el número real. Una página de error vistosa puede decir una cosa mientras el servidor devuelve otra. En su navegador, abra las herramientas de desarrollador, vaya a la pestaña Red, recargue la página y haga clic en la primera solicitud. El estado aparece en la parte superior del panel de encabezados. Desde una terminal: ```sh curl -sSI https://yourdomain.com/ ``` Eso muestra la línea de estado y los encabezados de la respuesta sin descargar la página. Los encabezados importan: varios de los casos siguientes se identifican por un encabezado y no solo por el código. ![Lectura de un estado de respuesta en las herramientas de desarrollador del navegador](https://support.kapsulehost.com/help/screenshots/http-error-codes.fdd177cf.webp) ## La versión resumida | Código | Significado | De quién es el problema | |---|---|---| | 401 | Se requiere autenticación | La protección con contraseña está activada | | 403 | Rechazado a propósito | Una regla de seguridad bloqueó la solicitud | | 404 | No encontrado | Su sitio, normalmente el enrutamiento | | 500 | Su aplicación falló | Su código o un plugin | | 502 | El servidor detrás del servidor web falló | Normalmente su aplicación | | 503 | Deliberadamente sin servir en este momento | Suspendido, pausado o en mantenimiento | | 504 | Tardó demasiado | Algo en su código es lento | ## 401 No autorizado Verá un cuadro de nombre de usuario y contraseña del navegador en lugar de una página. Eso significa que la protección básica con contraseña está activada en el sitio o en esa ruta. Desactívela, u obtenga las credenciales, desde **Sitios web**, el sitio, **Configuración** y luego **Protección con contraseña**. Consulte [Protección con contraseña](https://support.kapsulehost.com/es-es/site-password-protect). La renovación del certificado sigue funcionando mientras la protección con contraseña está activada, por lo que esto no afectará su HTTPS. ## 403 Prohibido 403 significa que algo rechazó la solicitud deliberadamente. En esta plataforma hay cuatro fuentes distintas. **El cortafuegos de aplicaciones web.** Cada sitio está detrás de un motor de reglas que inspecta las solicitudes entrantes y bloquea las que coinciden con patrones de ataque conocidos. Esta es la fuente más común de un 403 inesperado, y casi siempre es un falso positivo ante una solicitud legítima pero inusual: un envío de formulario largo, un creador de páginas guardando contenido complejo, un plugin publicando código sin procesar. Síntomas de un bloqueo del cortafuegos: una acción específica falla con 403 cada vez mientras el resto del sitio funciona bien, y falla igual en otro navegador y en otra red. La solución es una exclusión de regla específica, que el soporte puede añadir. No busque un interruptor para desactivar el cortafuegos; no existe tal cosa en el alojamiento compartido, y de todos modos sería la solución equivocada. Abra un ticket con la URL exacta, la hora exacta y lo que estaba haciendo. Consulte [Cómo abrir un ticket de soporte](https://support.kapsulehost.com/es-es/opening-a-support-ticket). **Geobloqueo.** Si ha restringido su sitio a países concretos, todos los demás reciben un 403. Revise **Configuración** y luego **Seguridad**. Consulte [Geobloqueo](https://support.kapsulehost.com/es-es/site-geo-blocking). **Un bloqueo de IP.** Ya sea uno que usted mismo añadió en Seguridad, o un bloqueo de abuso a nivel de plataforma. **Un problema de permisos de archivo o de enlace simbólico.** Menos frecuente, y normalmente aparece después de una operación manual de archivos por SSH. ## 404 No encontrado El servidor respondió, pero no hay nada en esa dirección. **Una sola página devuelve 404.** El archivo o la publicación realmente no existe, o la URL es incorrecta. **Todas las páginas excepto la de inicio devuelven 404.** Esto es un problema de enrutamiento, y en WordPress casi siempre son los enlaces permanentes. Importante: el alojamiento web de KapsuleHost usa nginx, no Apache, por lo que las reglas de reescritura de `.htaccess` no hacen nada aquí. Si migró desde un proveedor que las usaba, esa es su causa. Consulte [Problemas con los enlaces permanentes](https://support.kapsulehost.com/es-es/wordpress-permalink-issues) y [WordPress y .htaccess](https://support.kapsulehost.com/es-es/wordpress-htaccess). **Todo el sitio devuelve 404.** Compruebe que el sitio apunte a la raíz de documentos correcta y que su dominio esté vinculado al sitio correcto. Consulte [Dominio personalizado para un sitio web](https://support.kapsulehost.com/es-es/custom-domain-for-website). **Funciona en su máquina pero devuelve 404 en producción.** Los nombres de archivo en Linux distinguen entre mayúsculas y minúsculas. `Logo.PNG` y `logo.png` son dos archivos distintos. ## 500 Error interno del servidor Su aplicación se ejecutó y falló. El servidor web está bien; el código no lo está. Este es el caso en el que los registros le dan la respuesta casi de inmediato, porque un error fatal de PHP registra el archivo y el número de línea que falló, lo que normalmente nombra el plugin exacto. 1. Vaya a **Sitios web**, el sitio, **Configuración** y luego **Registros**. 2. Revise las entradas más recientes. 3. Haga coincidir la marca de tiempo con el momento en que vio el error. Consulte [Registros de errores](https://support.kapsulehost.com/es-es/error-logs). Para la versión específica de WordPress de este caso, donde la página aparece en blanco en lugar de mostrar un error, consulte [La pantalla blanca de WordPress](https://support.kapsulehost.com/es-es/wordpress-white-screen). Las causas más comunes son un plugin o tema incompatible con su versión de PHP, un límite de memoria alcanzado y un fallo en la conexión a la base de datos. Consulte [Extensiones y configuración de PHP](https://support.kapsulehost.com/es-es/php-extensions-and-ini) y [Límite de memoria de WordPress](https://support.kapsulehost.com/es-es/wordpress-memory-limit). ## 502 Puerta de enlace incorrecta El servidor web intentó entregar la solicitud a su aplicación y no obtuvo nada utilizable a cambio. El proceso de la aplicación rechazó la conexión o murió a mitad de la solicitud. Causas comunes: - Un proceso PHP se bloqueó, a menudo por quedarse sin memoria en una solicitud. - Una aplicación Node.js no se está ejecutando, o falló al iniciar. - Un pico de tráfico agotó los procesos de trabajo disponibles. Qué hacer: revise primero los registros, como se indicó antes. Si es una aplicación Node, compruebe si el proceso realmente está activo y revise su salida de inicio. Si los 502 aparecen solo en sus horas de mayor actividad, es un problema de capacidad y no un error. Consulte [Lentitud del sitio y límites de recursos](https://support.kapsulehost.com/es-es/site-slow-resource-limits). > **Note:** Un 502 proveniente del propio KPanel, al guardar una configuración, significa algo distinto. Significa que el panel no pudo aplicar el cambio de configuración al servidor web, y revirtió el cambio en lugar de dejar su sitio a medio configurar. Su sitio web no se ve afectado. Inténtelo de nuevo y, si sigue fallando, abra un ticket. ## 503 Servicio no disponible 503 significa que el servidor deliberadamente no está sirviendo en este momento. Hay tres causas específicas en esta plataforma, y la respuesta le indica cuál es. **Su sitio está suspendido.** Verá una página con el encabezado "This site is paused". Este es un estado de facturación o de cuenta, no un fallo técnico, y el sitio vuelve de inmediato cuando el estado se resuelve. Revise **Facturación**. Consulte [Pago fallido](https://support.kapsulehost.com/es-es/billing-failed-payment) y [Cuenta suspendida](https://support.kapsulehost.com/es-es/account-suspended). **Mantenimiento de la plataforma.** Una página de mantenimiento de toda la plataforma, lo cual es poco frecuente y se anuncia con antelación. Consulte [Estado y tiempo de actividad](https://support.kapsulehost.com/es-es/status-and-uptime). ## 504 Tiempo de espera de la puerta de enlace agotado Su aplicación todavía estaba funcionando cuando el servidor web se quedó sin paciencia. Nada falló. Simplemente fue demasiado lento. Causas típicas: - Una importación, exportación, copia de seguridad u operación masiva de larga duración ejecutada a través del navegador. - Un plugin que llama a una API externa lenta en cada carga de página. - Una consulta de base de datos costosa sin un índice detrás. - Una tarea cron activada por una visita a la página en lugar de por un cron real. Qué hacer: 1. Identifique qué solicitud es lenta. La pestaña APM en los sitios de WordPress se lo muestra. Consulte [Rendimiento del sitio](https://support.kapsulehost.com/es-es/site-performance). 2. Para operaciones largas, use la línea de comandos en lugar del navegador. Consulte [WP-CLI](https://support.kapsulehost.com/es-es/wordpress-wp-cli). 3. Traslade el trabajo programado a un cron real. Consulte [Tareas cron](https://support.kapsulehost.com/es-es/cron-jobs). 4. Aumente `max_execution_time` si el trabajo realmente necesita más tiempo, aunque esto es una solución provisional y no una corrección definitiva. Consulte [Extensiones y configuración de PHP](https://support.kapsulehost.com/es-es/php-extensions-and-ini). Tenga en cuenta la diferencia: si PHP alcanza primero su propio límite de ejecución, obtiene un 500, no un 504. Ambos significan "demasiado lento", en capas distintas. ## Sin ninguna respuesta A veces no hay ningún código de error, porque no hay ninguna respuesta. La conexión simplemente se queda colgada y finalmente agota el tiempo de espera. Si eso ocurre desde una red pero el sitio funciona desde otra, y especialmente desde un teléfono con datos móviles, la causa más probable es un bloqueo automático por abuso: una ráfaga de errores o intentos de inicio de sesión fallidos desde su dirección activó una prohibición temporal a nivel de red. Estas se eliminan por sí solas, normalmente en menos de una hora. Si necesita que se levante antes, contacte con soporte indicando la dirección IP desde la que se conecta. ## Páginas de error personalizadas Puede reemplazar la página de error predeterminada para 400, 401, 403, 404, 500, 502, 503 y 504 por su propio HTML, en **Sitios web**, el sitio, **Configuración** y luego **Páginas de error**. KapsuleHost proporciona páginas predeterminadas de marca para 404, 500, 502, 503 y 504 si usted no lo hace. Algo que vale la pena saber: una página de error personalizada conserva el código de estado real. Un 404 personalizado sigue devolviendo 404. Servir su página de error con un estado 200 es una manera clásica de destruir su posicionamiento en buscadores, y aquí está deliberadamente deshabilitado. Consulte [Páginas de error personalizadas](https://support.kapsulehost.com/es-es/site-error-pages). ## Guías relacionadas - [El sitio web no carga](https://support.kapsulehost.com/es-es/website-not-loading) - [Registros de errores](https://support.kapsulehost.com/es-es/error-logs) - [Lentitud del sitio y límites de recursos](https://support.kapsulehost.com/es-es/site-slow-resource-limits) - [Estado y tiempo de actividad](https://support.kapsulehost.com/es-es/status-and-uptime) - [Sitios web](https://support.kapsulehost.com/es-es/sites-overview) - [Glosario de alojamiento](https://support.kapsulehost.com/es-es/glossary)