Resposta breu: un error 502 Bad Gateway significa que el teu servidor web (anualment Nginx) ha demanat la pàgina al procés de PHP i ha rebut alguna cosa invàlid, o res. L’error està en la connexió entre ambdues capes, no normalment en les teves entrades o la teva base de dades.
En què es diferencia d’un 500
Un 500 sol indicar que l’aplicació o el servidor va fallar en atendre la petició. Un 502 normalment indica que una passarel· la no va rebre una resposta vàlida del servei upstream: el procés es va caure, va esgotar el seu temps o va ser acabat per superar un límit de memòria. La distinció importa perquè la solució està en els recursos i la configuració de processos, no en el codi del teu tema.
Constant o intermitent?
És el primer que cal establir. Un 502 constant sol seguir a un reinici de PHP, un mal desplegament o una mala configuració de CDN/ proxy. Un 502 intermitent que apareix sota càrrega gairebé sempre significa capacitat: el pool de processos PHP-FPM està esgotat, o les peticions superen el temps d’espera del galteway. Correlaciona l’hora amb el trànsit; un 502 sol en hores punta és un problema de dimensionament, no un bug.
Llegeix els dos registres
Mira el registre d’errors del servidor web per al missatge de Gateway, i el de PHP-FPM per a “server reached max_children” o processos acabats. Junts et diuen si et vas quedar sense processos, vas arribar a un timeout o et vas caure en una petició concreta. Revisa també /wp-content/debug.log per un error fatal dins d’una petició llarga.
Troba l’operació lenta o que falla
Identifica si ho dispara una acció: desar una entrada llarga, llançar una importació, obrir un informe o una pàgina que crida a una API externa lenta. Una única petició a un tercer penjada pot ocupar un procés fins que el gateway es rendeix. Mou les tasques realment llargues (copies, importacions) a la línia d’ordres o a un procés programat en comptes d’una petició web.
Què no fer, i com verificar
Recarrega una i altra vegada un 502 afegeix més peticions encallats a un pool saturat i allarga la caiguda. Puja tots els temps d’espera sense trobar l’operació lenta només converteix un error ràpid en un lent. Per verificar, reprodueix l’acció concreta que fallava amb una concurrència realista i confirma que la web ara degrada amb elegància en lloc de mantenir les peticions obertes.
CRITERI D’INCIDENT WP REPAIR
Reconstrueix la incidència abans de corregir-la
Un 502 descriu un intercanvi fallit entre passarel· la i upstream, no un únic error PHP. Correlacionar intermediari, servidor web i PHP-FPM distingeix procés caigut, timeout, sòcol o configuració upstream incorrecta.
- 1
Determina si el 502 és constant, d’una ruta o dependent de càrrega.
- 2
Fes coincidir l’hora del Gateway amb esdeveniments de PHP-FPM i del sistema.
- 3
Revisa sòcol o host upstream després de desplegaments i reinicieu-vos.
- 4
Identifica trucades externes o peticions llargues que ocupen processos fins que la passarel · la abandona.
Què ha de quedar verificat
- La ruta original funciona repetidament i amb concurrència realista.
- Els registres del Gateway i PHP-FPM no mostren nous errors upstream.
- Les dependències externes fallen ràpidament o degraden controladament.
Fonts tècniques oficials
Aquesta guia explica el diagnòstic. Si la web està afectada ara mateix, la intervenció ha de preservar una via de recuperació i verificar el recorregut real del negoci.
Veure el servei de reparació urgent →SOBRE ESTE SÍNTOMA
Preguntes freqüents d'aquesta guia.
Quina és la diferència real entre un error 502 i un error 500 en WordPress?+
Un 500 normalment significa que l’aplicació o el servidor ha fallat mentre manejava la petició en si. Un 502 significa que un gateway — sovint Nginx parlant amb PHP — va demanar una resposta a un procés ascendent i va obtenir alguna cosa invàlid o res en absolut, perquè aquest treballador es va estavellar, es va allunyar o va ser assassinat per excedir un límit de memòria. La solució per a un 502 viu en la configuració de recursos i processos, no generalment el seu codi theme.
Importa si el 502 només passa de vegades en lloc de constantment?+
Sí, aquesta distinció canvia el diagnòstic. Una constant 502 sovint segueix un reinici PHP, una mala implementació, o una mal arranjament de CDN/proxy, mentre que una intermitent 502 que apareix sota càrrega gairebé sempre apunta a la capacitat — un grup de treballadors PHP-FPM esgotat o peticions que excedeixen el temps d'espera de gateway. Correlating the timing with traffic patterns li indica amb quin estàs tractant.
Recarregar la pàgina repetidament ajudarà si estic rebent un 502?+
No — Recarrega repetidament afegeix més sol·licituds aturades a una piscina de treballadors ja saturada i estén el tall en comptes de resoldre-ho. És millor identificar l'operació específica lenta o penjant, com una trucada externa lenta API, que seguir intentant.
Elevar cada temps d'espera estableix una solució raonable per als 502s recurrents?+
No per si sol — augmentar cada temps d’espera sense trobar l’operació lenta real només converteix una falla ràpida en una lenta, mantenint les peticions obertes més temps sense reparar la causa. Tasques genuïnament llargues com còpies de seguretat o importacions s'han d’executar a través de la línia d’ordres o un procés programat en lloc d’una sol·licitud web.