Guía de códigos HTTP para sitios de Jetpack

Esta guía explica los códigos de estado HTTP (también llamados códigos de error) que puedes ver cuando Jetpack no puede conectarse a WordPress.com y cómo resolver cada uno.

Jetpack se conecta a WordPress.com mediante el archivo xmlrpc.php de tu sitio. Cuando esa solicitud falla, tu proveedor de alojamiento o WordPress.com devuelve un código de estado numérico que indica la causa. Estos códigos pueden aparecer en errores de conexión, en la Jetpack Herramienta de depuración (jptools.wordpress.com/debug), o en los registros del servidor.

Para obtener más información sobre los errores de diagnóstico que pueden producirse en las conexiones de Jetpack, consulta a esta página de soporte específica.

400 Solicitud incorrectaMD

Un error 400 («Solicitud incorrecta») significa que la solicitud de conexión no era válida o tenía un formato incorrecto, normalmente debido a una configuración incorrecta o a datos dañados. Causas habituales y soluciones:

• Las URL del sitio tienen un formato incorrecto, por ejemplo, si faltan barras o contienen caracteres no válidos. Confirma que las URL de tu sitio son correctas en el panel de administración de WordPress, en Configuración → General.
• La caché o las cookies del navegador están obsoletas. Borra la caché de tu sitio y vuelve a intentar conectarte.
• Problemas con la caché de DNS. La mayoría de los problemas de DNS se deben a una configuración incorrecta del dominio o del alojamiento, así que ponte en contacto con el equipo de soporte de tu proveedor.
• Los encabezados HTTP son incorrectos. Pide al equipo de soporte de tu proveedor que revise sus registros para confirmar si esta es la causa.
• Los conflictos entre plugins o temas hacen que Jetpack envíe solicitudes que WordPress.com no puede leer. Descarta que los plugins y temas sean el origen del problema.
• Los límites de tamaño de carga o de solicitud, o una configuración incorrecta de PHP y del servidor, interrumpen el procesamiento de solicitudes. Ponte en contacto con el equipo de soporte de tu proveedor para descartarlo.
• Hay entradas en el archivo .htaccess u otra configuración del servidor. Ponte en contacto con el equipo de soporte de tu proveedor para descartarlo.

401 No autorizadoMD

Un error 401 («No autorizado») significa que faltan las credenciales de autenticación o que son incorrectas, por lo que el servidor rechaza el intento de conexión. Causas habituales y soluciones:

• Las sesiones de inicio de sesión o los tokens de autenticación han caducado. Si hace tiempo que iniciaste sesión, cierra la sesión de WordPress.com (o del panel de administración de WordPress de tu sitio) y vuelve a iniciarla.
• La seguridad del sitio bloquea la conexión. Añade las direcciones IP de Jetpack a la lista de permitidas en tus plugins de seguridad o en la seguridad del servidor.
• Los datos de autenticación obsoletos están almacenados en la caché o las cookies del navegador. Borra la caché de tu sitio y vuelve a intentar conectarte.

403 ProhibidoMD

Un error 403 («Prohibido») significa que el servidor de tu proveedor rechaza la conexión debido a permisos insuficientes o reglas de seguridad, o porque un plugin de seguridad está bloqueando Jetpack. Causas habituales y soluciones:

• Jetpack no puede acceder a tu archivo xmlrpc.php. Asegúrate de que Jetpack pueda comunicarse con xmlrpc.php.
• Los archivos o directorios principales de WordPress no tienen los permisos correctos de lectura, escritura y ejecución. Ponte en contacto con el equipo de soporte de tu proveedor para diagnosticar y actualizar los permisos.

404 No encontradoMD

Un error 404 No encontrado significa que no se puede encontrar el recurso o punto de conexión necesario para establecer la conexión, normalmente el archivo xmlrpc.php de tu sitio. Causas habituales y soluciones:

• WordPress está instalado en un subdirectorio y las URL son incorrectas. Confirma las URL en el panel de administración de WordPress, en Configuración → General para que Jetpack pueda encontrar xmlrpc.php.
• Un plugin de seguridad o la configuración del servidor está bloqueando el acceso. Asegúrate de que xmlrpc.php no esté bloqueado.

408 Tiempo de espera de la solicitud agotadoMD

Un error 408 («Tiempo de espera de la solicitud agotado») significa que el servidor no pudo completar la solicitud a tiempo, normalmente debido a una red lenta, al rendimiento del servidor o a una implementación de seguridad. Este error es relativamente poco frecuente y más habitual en algunos proveedores que en otros. Ponte en contacto con el equipo de soporte de tu proveedor y pregunta si han implementado alguna medida de seguridad, como la protección contra DDoS, que pudiera hacer que fallen las solicitudes de conexión de Jetpack.

429 Demasiadas solicitudesMD

Un error 429 («Demasiadas solicitudes») significa que la seguridad ha limitado la frecuencia de los intentos de conexión para evitar la sobrecarga o el uso indebido del servidor. Causas habituales y soluciones:

• La configuración de seguridad, los cortafuegos o las reglas personalizadas del entorno de alojamiento están mal configurados o son demasiado restrictivos. Ponte en contacto con el equipo de soporte de tu proveedor para diagnosticar y resolver el problema.
• Una configuración de Cloudflare. Configura Cloudflare para que funcione correctamente con Jetpack.

500 Error interno del servidorMD

Un error 500 («Error interno del servidor») significa que un error en el servidor de tu proveedor impidió la solicitud de conexión de Jetpack. A menudo aparece así:

Error details:string(60) -32301: transport error – HTTP status code was not 200 (500)

Causas habituales y soluciones:

• El servidor está temporalmente inactivo o en mantenimiento por parte de tu proveedor. Otras causas del lado del servidor son las versiones de PHP no compatibles y el uso excesivo de recursos.
• Conflictos con otros plugins o con tu tema.
• Para solucionar el problema, consulta el registro de errores de PHP de tu sitio. Busca la marca de tiempo en la que se produjo el error y localiza las entradas relacionadas. Si no sabes cómo hacerlo, ponte en contacto con el equipo de soporte de tu proveedor.

502 Puerta de enlace incorrectaMD

Un error 502 («Puerta de enlace incorrecta») significa que una puerta de enlace o un servidor proxy recibió una respuesta no válida, o no recibió ninguna, de un servidor ascendente, lo que interrumpió la conexión. Ponte en contacto con el equipo de soporte de tu proveedor para investigarlo.

503 Servicio no disponibleMD

Un error 503 («Servicio no disponible») significa que el servidor, la puerta de enlace o el proveedor ascendente están temporalmente sobrecargados o fuera de servicio por mantenimiento. Normalmente es temporal. Espera e inténtalo de nuevo, o ponte en contacto con el equipo de soporte de tu proveedor si el problema persiste.

504 Tiempo de espera de la puerta de enlace agotadoMD

Un error 504 («Tiempo de espera de la puerta de enlace agotado») significa que el servidor no recibió una respuesta a tiempo de un servidor ascendente al intentar establecer la conexión. Ponte en contacto con el equipo de soporte de tu proveedor para investigarlo.