Error 502 Bad Gateway

Qué es un error 502 Bad Gateway, sus causas habituales en el upstream y en el proxy, cómo lo gestiona Googlebot y su impacto en el rastreo y la indexación.

Publicado por primera vez: 28 jun 2026 · Última actualización: 6 ago 2026 · Avanzado
Idiomas
1 señal de evidencia en esta página

Un 502 Bad Gateway significa que un proxy o gateway situado delante de su sitio (un CDN, un load balancer o un reverse proxy) recibió una respuesta inválida del servidor origin que hay detrás. Es un problema de infraestructura, no de Search Console. La documentación de Google agrupa el 502 con el 500 y el 503 bajo un mismo tratamiento 5xx: el rastreo se ralentiza de forma proporcional a cuántas URL fallan, el contenido de las respuestas 5xx se ignora y las páginas caen del índice si los errores persisten. Google no publica un umbral concreto de duración segura ni ninguna garantía de recuperación automática, así que un pico breve implica en la práctica mucho menos riesgo que uno que se repite; pero oficialmente no está libre de riesgo. Diagnostíquelo por capas (CDN, reverse proxy, origin) y correlacione la marca o las páginas de error con las cabeceras, los identificadores de traza y los logs, en lugar de confiar únicamente en la página de error.

TL;DR — Un 502 es un fallo de la capa de proxy/gateway: el RFC 9110 §15.6.3 lo define como un gateway o proxy que recibe una respuesta inválida de un servidor entrante. Se distingue de un 500 (la aplicación de origin falló) y de un 503 (el origin está deliberadamente no disponible). La documentación de Google agrupa el 500, el 502 y el 503 bajo un mismo tratamiento 5xx: la frecuencia de rastreo baja de forma proporcional al número de URL que fallan, el contenido 5xx se ignora y los errores persistentes hacen que las páginas caigan del índice. La recuperación es gradual una vez que se reanudan los 2xx, aunque Google no publica ningún plazo fijo. La duración importa, pero no hay un umbral oficial: los picos breves implican mucho menos riesgo práctico, mientras que los errores que se repiten son los que ponen las páginas en riesgo real; los comentarios de Mueller de noviembre de 2025 lo sitúan informalmente en torno a varios días, no como un SLA documentado. Diagnostíquelo por capas —CDN, reverse proxy u origin— y correlacione las evidencias entre saltos en lugar de confiar únicamente en una página de error con la marca del proveedor.

Qué señala realmente un 502

El RFC 9110 §15.6.3 define el 502 de forma específica: un gateway o proxy que recibe una respuesta inválida de un servidor entrante al que accedió mientras intentaba atender la solicitud. Ese límite que marca la especificación importa: identifica dónde observó el gateway el fallo, no necesariamente qué salto lo causó. El código de estado 502 es evidencia de un fallo en el límite, no prueba de que la aplicación de origin esté rota. Esa única distinción es la que difuminan la mayoría de los artículos de la competencia del tipo «13 formas de arreglarlo», y es la razón por la que el diagnóstico que sigue está organizado por capas en lugar de ser una lista plana. Evidence for this claim A 502 response means a gateway or proxy received an invalid response from an upstream server. Scope: RFC 9110 defines the gateway response semantics; it does not identify which infrastructure layer caused a specific failure. Confidence: high · Verified: IETF: RFC 9110 §15.6.3 — 502 Bad Gateway

Compare los códigos 5xx que se confunden con facilidad:

  • 500 Internal Server Error — la propia aplicación de origin falló (un error de código, una excepción no controlada, agotamiento de recursos). El origin respondió, y la respuesta fue «me he roto».
  • 502 Bad Gateway — el proxy recibió una respuesta mal formada o inválida del upstream (RFC 9110 §15.6.3).
  • 503 Service Unavailable — el origin está deliberadamente no disponible; este es el código intencionado y avalado por Google que significa «vuelva más tarde» y que se usa para el mantenimiento planificado, idealmente con una cabecera Retry-After.
  • 504 Gateway Timeout — el proxy esperó al upstream y no obtuvo nada antes de que expirara su tiempo de espera (RFC 9110 §15.6.5). (502 = mala respuesta; 504 = ninguna respuesta a tiempo.)
Evidence for this claim A 502 response means a gateway or proxy received an invalid response from an upstream server. Scope: RFC 9110 defines the gateway response semantics; it does not identify which infrastructure layer caused a specific failure. Confidence: high · Verified: IETF: RFC 9110 §15.6.3 — 502 Bad Gateway

La conclusión práctica: el 503 es el código que usted elige a propósito; el 502 es el código que le ocurre cuando falla la infraestructura.

Cómo gestiona Googlebot un 502

Esta es la parte que conviene fundamentar en la documentación real de Google en lugar de en el vago «puede perjudicar tu posicionamiento» que leerá en otros sitios. El documento HTTP and network errors de Google incluye 502 (bad gateway) como código 5xx y da a todos los códigos 5xx el mismo tratamiento:

  • La frecuencia de rastreo baja, de forma proporcional. Google reduce la frecuencia de rastreo del sitio, y la reducción es proporcional a cuántas URL individuales devuelven un error de servidor. Un puñado de 502 es algo menor; un 502 en todo el sitio es un «reduzca la marcha» contundente.
  • El contenido 5xx se ignora. Todo lo que Google recibe de una URL que devuelve un 5xx se ignora: no indexará una página de error 502 como si fuera su contenido.
  • La conservación en el índice es temporal. Las URL ya indexadas permanecen en el índice al principio, pero el sistema de indexación de Google elimina las URL que devuelven persistentemente un error de servidor.
  • La recuperación es automática y gradual. Una vez que el servidor vuelve a responder con 2xx, Google incrementa gradualmente la frecuencia de rastreo. Para una recuperación normal no hace falta reenviar nada, ni pedir una reconsideración, ni hacer heroicidades con “validate fix”: ese botón solo le dice a Google que vuelva a comprobarlo antes.

La conclusión más importante: el 502 se trata igual que el 500 y el 503. No es «menos grave» por originarse en la capa de proxy/CDN en lugar de en la aplicación de origin. El 502 tampoco cuenta con una excepción documentada. Evidence for this claim Google handles 502 with its general 5xx behavior: reduced crawling, ignored response content, and eventual removal of persistently failing URLs. Scope: Google explicitly lists 502 among 5xx server errors; it does not guarantee that a particular short outage has no ranking effect. Confidence: high · Verified: Google: How HTTP status codes affect Google's crawlers

La duración lo es todo

Que un 502 le perjudique realmente depende de cuánto dure, pero Google no publica una duración segura fija ni un umbral fijo de caída del índice, así que trate lo siguiente como matiz práctico, no como un SLA:

  • Un pico breve (de minutos a unas pocas horas) → la reducción de la frecuencia de rastreo de Google escala con cuántas URL están fallando, de modo que un pico corto y de poco alcance tiene un impacto práctico limitado y, en general, no merece la pena perseguirlo en Search Console. Nada en la documentación de Google exime formalmente a los errores cortos: es una cuestión de grado, no un corte tajante.
  • Un error que se repite o se mantiene → esta es la franja en la que se aplica la formulación de Google “persistently return a server error” (traducción: «devuelven persistentemente un error de servidor»), y las páginas pueden empezar a caerse del índice. Google no define “persistently” como un número concreto de días. El comentario público de Mueller (más abajo) lo situó informalmente en torno a varios días, con una recuperación bastante rápida una vez que el sitio está sano, pero esa es la lectura de un profesional sobre un incidente concreto, no una regla documentada en la que pueda confiar para cualquier sitio o CDN.

Esto encaja de forma aproximada con la interrupción de Cloudflare de noviembre de 2025, cuando una oleada de sitios devolvió errores 5xx sin tener culpa alguna. La respuesta pública de Mueller en Bluesky fue que con un 5xx el rastreo se ralentiza, pero “ramps back up” (traducción: «vuelve a incrementarse»); consulte la pestaña Citas para ver la formulación exacta y las advertencias sobre las fuentes, incluido un comentario aparte sobre “multiple days” transmitido a través del resumen de un tercero en lugar de verificado contra el hilo original. Una interrupción breve y confirmada por el proveedor se acerca al mejor de los casos: es visible, normalmente se resuelve por sí sola y, una vez que el proveedor confirma la recuperación y sus propias respuestas 2xx se han reanudado, la reacción razonable suele ser abstenerse de hacer cambios de infraestructura en lugar de hacerlos de forma reactiva.

Diagnosticar un 502 por capas

Como un 502 es un fallo de comunicación entre servidores, la forma más rápida de localizarlo es bajar por la pila —CDN, después reverse proxy y después origin— en lugar de recorrer una lista de comprobación plana. (La pestaña Árboles de decisión incluye esto como un recorrido guiado.)

Una advertencia antes de empezar: una página de error con la marca del proveedor, el nombre de un proveedor en una cabecera o el «aspecto» de una interrupción es una señal de evidencia, no la prueba de qué salto falló. Correlaciónela con las cabeceras de respuesta, los identificadores de solicitud o de traza y los logs con marca de tiempo a ambos lados del salto antes de concluir «es el CDN» o «es mi origin».

Capa de CDN / edge

  • Timeout del upstream: el nodo de edge no pudo obtener a tiempo una respuesta del origin.
  • El edge no puede alcanzar el origin en absoluto: fallo de resolución DNS, fallo del handshake SSL/TLS, o el firewall o la seguridad del origin bloqueando los rangos de IP del CDN.
  • Las causas documentadas varían según el proveedor: la documentación de resolución de problemas de Cloudflare describe escenarios de conectividad con el origin y de timeout específicos de su red de edge, mientras que AWS CloudFront documenta su propio conjunto de causas de TLS, DNS, puertos y funciones de origin; consulte la documentación de su CDN concreto en lugar de asumir que la lista de causas de un proveedor se aplica a otro.
  • La interrupción del propio proveedor de CDN (Cloudflare, Fastly, AWS, etc.): un evento de 502 masivo en sitios sin relación entre sí que no tiene nada que ver con la salud de su servidor; confírmelo con la página de estado del proveedor, no solo con la marca que aparece en la página de error.

Capa de reverse proxy / load balancer (Nginx, mod_proxy de Apache, HAProxy)

  • Timeout del backend o conexión rechazada.
  • Un bloque proxy_pass / upstream mal configurado que apunta al lugar equivocado.
  • Agotamiento del pool del backend: todos los workers del upstream están ocupados.
  • Incompatibilidad de SSL/TLS entre el proxy y el backend.

Capa del servidor origin

  • Caída o reinicio de la aplicación o de PHP-FPM, o un OOM kill (límite de memoria superado).
  • Agotamiento de las conexiones a la base de datos.
  • Un despliegue o reinicio que provoca una breve indisponibilidad.
  • Un WAF o un plugin de seguridad que bloquea IP legítimas de proxies o rastreadores como si fueran atacantes; este es el caso traicionero, porque los navegadores normales funcionan bien mientras el proxy (o Googlebot) recibe 502s.

Ese último patrón merece mencionarse: si solo Googlebot o solo las solicitudes que pasan por el CDN reciben 502s mientras los navegadores normales no, se trata de un bloqueo específico de bots o de un problema de respuestas variables, no de una interrupción real. Pruebe el acceso directo al origin frente al acceso a través del CDN, y verifique qué ve realmente Googlebot con la prueba en vivo de URL Inspection (Inspección de URLs) de Search Console, en lugar de dar por supuesto un impacto continuado a partir de un informe Server error (5xx) que puede estar ya desactualizado.

Corregir y prevenir los 502s

Las correcciones son específicas de cada capa, y quién debe aplicarlas varía según el rol:

  • Visitante — nada que corregir. Recargue una vez, pruebe con otra red si sospecha que hay un problema local y, por lo demás, espere; los cambios en el navegador no pueden reparar un fallo entre servidores.
  • Propietario del sitio sin acceso a la infraestructura — confirme el alcance y revise primero las páginas de estado y los logs (vea la lista de comprobación más abajo), y después escale a su hosting, al soporte del CDN o a su equipo de desarrollo en lugar de adivinar una solución.
  • Responsable del hosting, del CDN o de la aplicación — corrija la configuración del proxy y del upstream, aumente los timeouts y la capacidad del backend allí donde el origin sea el cuello de botella real, y escalone los despliegues para que los reinicios no afecten a todo el pool. Trate la inclusión en la lista de permitidos del WAF, los cambios en el firewall y las modificaciones de la configuración del proxy o del upstream como cambios que requieren aprobación: aplíquelos solo después de que los logs y las evidencias del proveedor muestren realmente un fallo del firewall o del control de acceso, no como una primera reacción a ciegas; permitir un CDN o un rastreador no es una solución genérica para un 502.

Para la prevención, gana lo aburrido: monitorización de disponibilidad con alertas, monitorización de los logs de error del servidor y del proxy, vigilar Host status y la tendencia de Server error (5xx) en las estadísticas de rastreo de Search Console, y correlacionar los picos con las páginas de estado de sus proveedores de CDN y DNS para poder distinguir «mi problema» de «su interrupción» en segundos.

Los códigos relacionados que conviene tener claros están justo al lado en este clúster: el de origin 500, el intencionado 503 y el de timeout 504.

Try it live

This is a real endpoint on this site — not a simulation. Hit it from the button, open it in a new tab, or curl -i it from your terminal, and the server answers with the actual status code this article is about.

Open in new tab ↗

Add an expert note

Pin an expert quote

New person? Create their unclaimed profile at /admin/experts/ → Pin a quote first.