Códigos de Error HTTP en KapsuleHost

What 403, 404, 500, 502, 503 and 504 actually mean on this platform, and the specific thing to do about each one.

Códigos de error HTTP en KapsuleHost

Qué significan realmente 403, 404, 500, 502, 503 y 504 en esta plataforma, y qué hacer específicamente en cada caso.

Un código de error no es un mensaje de fallo genérico. Te dice qué capa de la pila se rindió, y eso reduce enormemente las posibles causas. Un 502 y un 504 se ven idénticos para un visitante pero tienen causas y soluciones completamente diferentes.

Leer el código real

Antes de solucionar problemas, obtén el número real. Una página de error bonita puede decir una cosa mientras el servidor devuelve otra.

En tu navegador, abre las herramientas de desarrollador, ve a la pestaña Network, recarga la página y haz clic en la primera solicitud. El estado aparece en la parte superior del panel Headers.

Desde una terminal:

curl -sSI https://yourdomain.com/

Eso imprime la línea de estado y los encabezados de respuesta sin descargar la página. Los encabezados importan: varios de los casos siguientes se identifican por un encabezado en lugar del código solo.

La versión corta

Código	Significado	Responsabilidad de
401	Autenticación requerida	La protección por contraseña está activada
403	Rechazado intencionalmente	Una regla de seguridad bloqueó la solicitud
404	No encontrado	Tu sitio, generalmente enrutamiento
500	Tu aplicación falló	Tu código o un complemento
502	El servidor detrás del servidor web falló	Generalmente tu aplicación
503	Deliberadamente no sirviendo ahora	Suspendido, pausado o mantenimiento
504	Tardó demasiado	Algo en tu código es lento

401 No autorizado

Verás un cuadro de nombre de usuario y contraseña del navegador en lugar de una página. Eso significa que la protección por contraseña básica está habilitada en el sitio o en esa ruta.

Desactívala u obtén las credenciales desde Websites, el sitio, Advanced, luego Password protection. Ver Protección por contraseña.

La renovación de certificados continúa funcionando mientras la protección por contraseña está activada, por lo que esto no romperá tu HTTPS.

403 Prohibido

403 significa que algo rechazó deliberadamente la solicitud. En esta plataforma hay cuatro fuentes distintas.

El firewall de aplicación web. Cada sitio está detrás de un motor de reglas que inspecciona 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 en una solicitud legítima pero inusual: un envío de formulario largo, un generador de páginas guardando contenido complejo, un complemento publicando código sin procesar.

Síntomas de un bloqueo de firewall: una acción específica falla con 403 cada vez mientras el resto del sitio está bien, y falla de forma idéntica en un navegador diferente y en una red diferente.

La solución es una exclusión de regla dirigida, que el soporte puede agregar. No busques un interruptor para apagar el firewall; no hay uno para alojamiento compartido, y sería la solución incorrecta de todos modos. Abre un ticket con la URL exacta, la hora exacta y lo que estabas haciendo. Ver Abrir un ticket de soporte.

Bloqueo geográfico. Si has restringido tu sitio a países particulares, todos los demás obtienen un 403. Comprueba Advanced, luego Security. Ver Bloqueo geográfico.

Un bloqueo de IP. Uno que agregaste tú mismo bajo Security, o un bloqueo de abuso a nivel de plataforma.

Un problema de permisos de archivo o enlace simbólico. Menos común, y generalmente aparece después de una operación manual de archivo sobre SSH.

404 No encontrado

El servidor respondió, pero no hay nada en esa dirección.

Una página 404. El archivo o la publicación genuinamente no está allí, o la URL es incorrecta.

Cada página excepto la página de inicio 404. Este es un problema de enrutamiento, y en WordPress casi siempre son los enlaces permanentes. Importante: el alojamiento web Kapsule ejecuta nginx, no Apache, por lo que las reglas de reescritura .htaccess no hacen nada aquí. Si migraste desde un host que las usaba, esa es tu causa. Ver Problemas de enlaces permanentes y WordPress y .htaccess.

Todo el sitio 404. Comprueba que el sitio esté apuntando a la raíz de documentos correcta y que tu dominio esté asociado al sitio correcto. Ver Dominio personalizado para un sitio web.

Funciona en tu máquina y 404 en directo. Los nombres de archivo de Linux distinguen entre mayúsculas y minúsculas. Logo.PNG y logo.png son dos archivos diferentes.

500 Error interno del servidor

Tu aplicación se ejecutó y falló. El servidor web está bien; el código no.

Este es el único caso en el que los registros te dan la respuesta casi inmediatamente, porque un error fatal de PHP registra el archivo y el número de línea que falló, lo que generalmente nombra el complemento exacto.

Ve a Websites, el sitio, Advanced, luego Logs.
Mira las entradas más recientes.
Haz coincidir la marca de tiempo con cuándo viste el error.

Ver Registros de error. Para la versión específica de WordPress de esto, donde la página está en blanco en lugar de mostrar un error, ver La pantalla blanca de WordPress.

Las causas más comunes son un complemento o tema incompatible con tu versión de PHP, un límite de memoria alcanzado y una conexión de base de datos fallida. Ver Extensiones y configuración de PHP y Límite de memoria de WordPress.

502 Puerta de enlace incorrecta

El servidor web intentó entregar la solicitud a tu aplicación y no obtuvo nada utilizable. El proceso de aplicación rechazó la conexión o murió a mitad de la solicitud.

Causas comunes:

Un proceso PHP falló, a menudo por quedarse sin memoria en una solicitud.
Una aplicación Node.js no se está ejecutando o falló al iniciarse.
Una ráfaga de tráfico agotó los procesos de trabajo disponibles.

Qué hacer: comprueba los registros primero, como se indica arriba. Si es una aplicación de Node, comprueba si el proceso está realmente activo y mira su salida de inicio. Si los 502 aparecen solo en tus momentos más ocupados, es un problema de capacidad en lugar de un error. Ver Lentitud del sitio y límites de recursos.

Un 502 de KPanel en sí mismo, al guardar una configuración, significa algo diferente. Significa que el panel no pudo aplicar el cambio de configuración al servidor web, y revirtió el cambio en lugar de dejar tu sitio a medio configurar. Tu sitio web no se ve afectado. Intenta de nuevo, y si continúa fallando, abre un ticket.

503 Servicio no disponible

503 significa que el servidor deliberadamente no está sirviendo ahora. Hay tres causas específicas en esta plataforma, y la respuesta te dice cuál.

Tu sitio está suspendido. Verás una página encabezada "This site is paused". Este es un estado de facturación o cuenta, no una falla técnica, y el sitio vuelve directamente cuando se aclara el estado. Comprueba Billing. Ver Pago fallido y Cuenta suspendida.

Un proyecto Orbit alcanzó su límite de gasto. La respuesta lleva el encabezado X-Orbit-Paused: spending-cap, y la página dice que el sitio ha alcanzado su límite de gasto mensual. Este confunde a la gente porque nada está roto y no se necesita ningún ticket de soporte. El proyecto deliberadamente dejó de servir para que no recibas una factura inesperada.

Para reanudar: ve a Orbit, el proyecto, Settings, luego Spending cap, y aumenta el límite. El servicio se reanuda una vez que se recoge el cambio, lo que puede tardar hasta una hora. También se reanuda automáticamente al inicio del próximo período de facturación. Ver Límites de gasto de Orbit.

Mantenimiento de plataforma. Una página de mantenimiento de toda la plataforma, que es rara y anunciada. Comprueba Estado y disponibilidad.

504 Tiempo de espera de la puerta de enlace

Tu aplicación seguía 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 complemento que llama a una API externa lenta en cada carga de página.
Una consulta de base de datos cara sin índice detrás.
Una tarea cron activada por una vista de página en lugar de por cron real.

Qué hacer:

Identifica qué solicitud es lenta. La pestaña APM en sitios de WordPress te lo muestra. Ver Rendimiento del sitio.
Para operaciones largas, usa la línea de comandos en lugar del navegador. Ver WP-CLI.
Mueve el trabajo programado a cron real. Ver Trabajos cron.
Aumenta max_execution_time si el trabajo genuinamente necesita más tiempo, aunque esto es una solución alternativa en lugar de una corrección. Ver Extensiones y configuración de PHP.

Ten en cuenta la diferencia: si PHP alcanza primero su propio límite de ejecución obtienes un 500, no un 504. Ambos significan "demasiado lento", en capas diferentes.

Sin respuesta en absoluto

A veces no hay código de error, porque no hay respuesta. La conexión simplemente se cuelga y eventualmente agota el tiempo de espera.

Si eso sucede desde una red pero el sitio funciona desde otra, y especialmente desde un teléfono en datos móviles, la causa más probable es un bloqueo automático de abuso: una ráfaga de errores o intentos de inicio de sesión fallidos desde tu dirección activó una prohibición temporal a nivel de red. Estos se aclaran solos, generalmente dentro de una hora. Si necesitas que se levante antes, contacta con el soporte con la dirección IP desde la que te estás conectando.

Páginas de error personalizadas

Puedes reemplazar la página de error predeterminada para 400, 401, 403, 404, 500, 502, 503 y 504 con tu propio HTML, bajo Websites, el sitio, Advanced, luego Error pages. Kapsule proporciona valores predeterminados marcados para 404, 500, 502, 503 y 504 si no los tienes.

Una cosa que vale la pena saber: una página de error personalizada mantiene el código de estado real. Un 404 personalizado aún devuelve 404. Servir tu página de error con un estado 200 es una forma clásica de destruir tu clasificación en los motores de búsqueda, y deliberadamente no es posible aquí. Ver Páginas de error personalizadas.