Resposta breu: Un 504 Gateway Timeout significa que un servidor upstream (PHP, o un intermediari davant) no va respondre a temps i la petició es va tallar. Alguna cosa va trigar massa: una consulta lenta, una trucada externa penjada o una operació pesada en una petició web.
Què sol esgotar el temps
- Una importació, exportació o còpia per navegador en comptes de la línia d’ordres.
- Una API externa lenta o que no respon, crida durant la generació de la pàgina.
- Una consulta que recorre moltes més files de les que hauria, sovint en una taula gran.
- Operacions massives: regenerar miniatures, actualitzar molts productes.
- Un timeout d’CDN o intermediari més curt del que necessita l’origen.
Troba l’operació lenta
Activa WP_DEBUG_LOG i revisa els registres del servidor i de PHP-FPM pel que s’ executava en saltar el timeout. Usa Query Monitor a la pàgina lenta per exposar una consulta sense índex o sense límits i el plugin que la dispara. Si una acció concreta el provoca —una importació, un informe —, això acota la recerca immediatament.
Puja el temps només on correspon
Per a una migració puntual real pots pujar temporalment els timeouts de l’intermediari i de PHP. Però en una pàgina que carreguen visitants reals, un timeout major només manté un procés ocupat més temps i redueix quantes viwebs aténs. La solució duradora és fer ràpida l’operació, o moure les tasques realment llargues a WP-CLI o a un procés programat.
Verifica
Reprodueix l’acció exacta que va agotar el temps en condicions realistes i confirma que ara acaba enfonsadament dins del límit, no just per sota. Si era una API externa, confirma que la web degrada amb elegància en lloc de penjar- se quan aquest servei va lent.
CRITERI D’INCIDENT WP REPAIR
Reconstrueix la incidència abans de corregir-la
Un 504 és la passarel· la abandonant mentre l’upstream segueix sense acabar. La reparació és trobar l’operació o dependència lenta, no ampliar tots els timeouts.
- 1
Anota ruta o acció exacta i durada del timeout del gateway.
- 2
Correlaciona registres de servidor intermediari, PHP-FPM, aplicació i consultes lentes.
- 3
Identifica importacions, informes, APIs o consultes sense límits associades.
- 4
Treu treballs llargs de la petició web o afegeix timeouts limitats i observables a dependències.
Què ha de quedar verificat
- l’operació original acaba amb marge segur.
- Les peticions normals responen mentre s' executa.
- Les dependències externes esgoten temps i degraden de manera predictible.
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.
És un 504 el mateix problema que un error 503?+
No. Un 504 significa que un servidor ascendent, típicament PHP o un intermediari davant d’ell, no va respondre dins del temps permès, apuntant a una cosa que pren massa temps per executar. Un 503 generalment significa que el servidor no podia manejar la petició en absolut, sovint degut a un fitxer de manteniment encallat o recursos esgotats, no una operació lenta.
Hauria d'incrementar el límit de temps d'espera cada vegada que veig un 504?+
Només per a una tasca única genuïna com una migració. L’augment del temps d’espera en una pàgina real els visitants tan sols carreguen a un treballador ocupat més temps i redueix la quantitat de visitants que el servidor pot manejar alhora, no arregla l’operació lenta subjacent.
Quina és la manera correcta d’executar una gran importació o exportació sense colpejar un 504?+
Executar-lo a través de WP-CLI o un procés de fons programat en comptes de a través del navegador. Importacions, exportacions i còpies de seguretat activades pel navegador són exactament el tipus d’operacions de llarga durada que comunament superen el temps d’espera intermediari o PHP.
Com puc esbrinar quina consulta o plugin està causant realment el temps d'espera?+
Habilita WP_ DEBUG_ LOG i comprova el servidor i els registres PHP-FPM del que s'estava executant quan es va produir el temps d’espera, després useu una eina com a Query Monitor a la pàgina lenta per exposar una consulta no indiçada o sense límit i identificar el plugin que el dispara.