Erreur 504 WordPress : la tâche a-t-elle fini en fond ?

Schéma isométrique de serveurs web illustrant le mécanisme d'une erreur 504 wordpress
Creil – Chambly – Chantilly – Clermont – Abbeville – Albert – Amiens – Beaumont-sur-Oise – Cergy – Château-Thierry – Chauny – Compiègne – Crévecœur-le-Grand – Grandvilliers – L'Isle-Adam – Lacroix-Saint-Ouen – Laon – Montdidier – Nanteuil-le-Haudouin – Nogent-sur-Oise – Noyon – Péronne – Persan – Pontoise – Roissy-en-France – Roye – Saint-Maximin (60) – Saint-Quentin – Soissons – Tergnier – Thourotte – Villers-Cotterêts – Département de l'Aisne (02) – Département de la Somme (80) – Estrées-Saint-Denis – Gouvieux – Lamorlaye – Liancourt – Margny-lès-Compiègne – Méru – Ribécourt-Dreslincourt – Saint-Just-en-Chaussée – Senlis – Beauvais – Breteuil – Montataire – Mouy – Pont-Sainte-Maxence – Villers-Saint-Paul – Crépy-en-Valois – Creil – Chambly – Chantilly – Clermont – Abbeville – Albert – Amiens – Beaumont-sur-Oise – Cergy – Château-Thierry – Chauny – Compiègne – Crévecœur-le-Grand – Grandvilliers – L'Isle-Adam – Lacroix-Saint-Ouen – Laon – Montdidier – Nanteuil-le-Haudouin – Nogent-sur-Oise – Noyon – Péronne – Persan – Pontoise – Roissy-en-France – Roye – Saint-Maximin (60) – Saint-Quentin – Soissons – Tergnier – Thourotte – Villers-Cotterêts – Département de l'Aisne (02) – Département de la Somme (80) – Estrées-Saint-Denis – Gouvieux – Lamorlaye – Liancourt – Margny-lès-Compiègne – Méru – Ribécourt-Dreslincourt – Saint-Just-en-Chaussée – Senlis – Beauvais – Breteuil – Montataire – Mouy – Pont-Sainte-Maxence – Villers-Saint-Paul – Crépy-en-Valois
Table des matières

Vous êtes tranquillement dans votre tableau de bord un mardi à 18h. Vous lancez une mise à jour majeure de WooCommerce, une synchronisation de catalogue de 15 000 produits ou une migration de base de données. La roue tourne dans le navigateur. Trente secondes. Soixante secondes. Deux minutes. Et là, c’est la sanction brutale en plein écran : écran blanc austère et ce message assassin, 504 Gateway Timeout. La sueur froide arrive instantanément.

La première angoisse qui vous prend aux tripes est limpide : est-ce que mon opération est passée ou est-ce que tout vient d’exploser au milieu ? Si vous cliquez sur rafraîchir, allez-vous doubler les lignes dans la table SQL ou achever un processus à moitié écrit ? C’est le grand classique du dépannage chez mes clients. Quand on m’appelle en panique à mon agence web dans l’Oise pour ce cas précis, je réponds toujours la même chose : lâchez immédiatement cette touche F5 et venez voir ce qui se passe sous le capot.

L’erreur 504 wordpress n’est pas un message d’erreur d’application ordinaire. C’est une porte claquée au nez par un intermédiaire réseau. Comprendre ce qui arrive à votre tâche en arrière-plan réclame d’oublier deux minutes l’interface graphique de WordPress pour aller regarder la machinerie serveur droit dans les yeux.

Comprendre le drame du timeout entre votre proxy et PHP-FPM

Posons le décor réseau. Quand vous demandez à WordPress d’exécuter une action lourde via votre navigateur, votre requête ne tape pas directement sur le moteur PHP. Elle traverse d’abord une passerelle : un reverse proxy Nginx, un répartiteur de charge, ou le proxy de Cloudflare. Ce composant frontal prend votre commande et la transmet à PHP-FPM, qui lui-même discute avec MySQL. Le proxy attend que le traitement se termine pour vous renvoyer la réponse HTTP 200 avec la page terminée.

Le problème ? Ce frontal a de la patience, mais pas trop. Par défaut, Nginx ou Apache est configuré pour abandonner la liaison si le backend met plus de 30 ou 60 secondes à répondre. Quand ce compte à rebours tombe à zéro, le proxy n’a pas reçu le moindre octet de réponse. Il jette l’éponge et envoie au visiteur le statut HTTP 504 défini par la spécification MDN du code 504 Gateway Timeout. Mais attention : cela ne préjuge absolument rien de l’état du moteur applicatif sous-jacent.

Qui coupe le sifflet en premier ?

Il faut distinguer deux limites radicalement différentes. La première est la durée maximale de garde de la connexion TCP par le serveur mandataire (proxy_read_timeout ou fastcgi_read_timeout). La seconde est la durée maximale allouée au moteur PHP pour mouliner (max_execution_time dans votre fichier php.ini). Sur un serveur mutualisé d’entrée de gamme ou mal réglé, le frontal lâche souvent l’affaire bien avant que PHP n’ait atteint son propre plafond. C’est précisément là que réside le quiproquo anxiogène.

Votre écran crache une page d’erreur. Vous croyez le site mort. Pourtant, sur la machine, les coeurs CPU tournent peut-être encore à plein régime pour insérer vos métadonnées WooCommerce. C’est tout le piège.

Le gouffre entre le navigateur et le serveur

Quand le proxy renvoie ce code 504 au client, la socket de communication entre votre navigateur et le serveur est close. Pour votre écran, la session est terminée. Pour le serveur, personne n’a forcément prévenu le worker PHP qu’il parlait désormais dans le vide. Deux univers parallèles se créent : l’interface qui hurle à l’échec et le backend qui continue docilement sa corvée.

La tâche s’est-elle terminée malgré la page blanche ?

Venons-en au fait : la tâche est-elle morte ou vivante ? Dans le jargon, c’est le paradoxe du chat de Schrödinger version serveur Linux. La réponse technique dépend d’une directive PHP fondamentale : ignore_user_abort. Que se passe-t-il quand le client coupe la connexion ?

Si la directive est à zéro et que votre script tente d’envoyer un flush de données vers un tampon inexistant, le moteur PHP peut s’interrompre immédiatement sur détection d’une socket brisée. À l’opposé, si le script utilise ignore_user_abort(true) — ce que font la plupart des outils d’exportation ou d’importation sérieux ainsi que le noyau lors d’une mise à jour de fichier —, PHP se moque éperdument que votre navigateur soit parti voir ailleurs. Il va s’exécuter jusqu’au bout, ou jusqu’à heurter un max_execution_time fatal ou un manque de mémoire vive (memory_limit).

Une erreur 504 n’est pas un crash de votre script : c’est simplement un portier trop pressé qui est parti avant que le livreur n’ait fini de décharger le camion.

Le comportement par défaut lors des mises à jour du coeur

Lors d’une mise à jour de WordPress ou d’un plugin lourd, le système télécharge une archive zip, décompresse les fichiers, écrase l’arborescence puis exécute d’éventuelles modifications de schémas de base de données. Si le réseau de votre hébergeur rame pendant le curl du fichier zip ou si la décompression prend 45 secondes sur un disque saturé, la passerelle expire. Résultat ? Vous vous prenez la 504 en pleine figure. Pourtant, si vous attendez trois minutes de plus, vous découvrirez souvent que les fichiers ont fini d’être copiés et que le mode maintenance s’est levé tout seul. Si vous aviez paniqué en coupant le serveur, vous auriez laissé un dossier wp-content corrompu à moitié remplacé.

La roulette russe des imports et migrations de base de données

Le cas le plus vicieux concerne les imports SQL bruts ou les plugins de synchronisation ERP. Si le script n’est pas taillé pour fonctionner en tranches atomiques (chunks), il s’arrête net dès que le timeout PHP intervient quelques secondes après le timeout proxy. Dans cette situation, vous avez un jeu de données tronqué en plein vol : des commandes sans lignes de facturation, ou des utilisateurs sans métadonnées associées. Vouloir relancer aveuglément l’opération crée des doublons en série, voire bloque les clés primaires.

Console de diagnostic affichant l'activité serveur lors d'une erreur 504 wordpress

Comment vérifier immédiatement si votre script tourne encore ?

Au lieu de trembler devant votre écran blanc ou de marteler le bouton rafraîchir, adoptez les bons réflexes de développeur web. Le premier geste ne se fait jamais dans le navigateur, il se fait en SSH sur votre hébergement. Si vous avez un accès terminal (sur un VPS ou un hébergement comme o2switch avec accès cPanel/Terminal), tapez cette commande sans attendre pour observer les processus PHP actifs :

# Voir les processus PHP en cours d'exécution et leur consommation CPU
ps aux | grep php-fpm

# Ou pour surveiller en temps réel avec un outil interactif
htop -u $(whoami)

Regardez l’utilisation processeur du worker rattaché à votre compte. Si un processus tourne à 80% ou 100% de CPU depuis 90 secondes, félicitations : votre tâche est vivante et se bat sur la machine. Laissez-lui la paix. Ne touchez à rien.

Si vous n’avez pas de console SSH sous la main, filez sur votre gestionnaire de base de données via phpMyAdmin ou votre client SQL préféré et exécutez la commande suivante :

SHOW FULL PROCESSLIST;

Vous verrez instantanément si une requête ALTER TABLE, UPDATE ou une série d’INSERT est en train de travailler activement sur vos tables. Tant que l’état indique « Updating » ou « Sending data » avec un compteur de secondes qui évolue, la base de données est vivante. Interrompre la machine à ce moment précis est le moyen garanti d’exploser l’intégrité de vos index InnoDB.

Pourquoi recharger la page est la pire bêtise à commettre

Soyons clairs deux minutes. Quand vous prenez un timeout 504, votre instinct d’utilisateur frustré vous pousse à faire F5. C’est l’erreur fatale. Voici précisément ce qui se passe quand vous faites ça :

  • L’avalanche de processus concurrents : Si le premier worker PHP est encore en train de traiter votre tableau de données géant, appuyer sur F5 lance un SECOND worker PHP sur la même tâche lourde. Votre serveur se retrouve avec deux processus qui se disputent le CPU et les verrous de tables.
  • Le verrouillage de table (Deadlock) : Deux scripts qui essaient de modifier la même table wp_posts ou wp_postmeta simultanément vont heurter les mécanismes de lock de MySQL. Résultat : tout se bloque. Votre serveur tombe à genoux et bascule directement en erreur 503 wordpress pour tout le monde.
  • La corruption des fichiers : Lors de la copie de dossiers de mise à jour, deux requêtes en écriture qui se chevauchent peuvent écrire des fichiers incomplets. C’est le chemin le plus court vers l’écran blanc de la mort (WSOD) avec des erreurs de syntaxe fatales.

Pour vous aider à déterminer l’état réel de votre tâche après l’apparition du code 504, j’utilise cette grille de diagnostic pragmatique sur mes propres chantiers :

Indicateur technique Statut probable de la tâche Action immédiate recommandée
CPU élevé sur php-fpm dans le terminal La tâche tourne encore en arrière-plan Attendre 3 à 5 minutes sans toucher au site
Processlist SQL active (Requêtes en cours) Écriture en base de données active Ne pas redémarrer MySQL ni couper PHP
Zéro processus PHP et aucune requête SQL Le script a été tué (timeout ou OOM) Consulter error.log et nettoyer les données partielles
Fichier .maintenance présent à la racine Mise à jour interrompue ou en finalisation Vérifier les logs avant de supprimer le fichier

Régler les timeouts sans créer une passoire à ressources

Quand on demande de l’aide sur des forums obscurs, la réponse standard des bidouilleurs est : « Montez les timeouts à 600 secondes ! ». Non. Pitié. C’est du pur bricolage d’apprenti sorcier.

Augmenter aveuglément les valeurs de timeout ne résout aucun dysfonctionnement structurel : cela autorise juste les requêtes pourries à monopoliser vos workers PHP dix fois plus longtemps. En cas de pic de trafic ou d’attaque par des bots, si vos workers restent scotchés pendant 5 minutes sur des boucles lentes, la file d’attente sature immédiatement. Plus aucun visiteur normal ne peut afficher la moindre page. Cependant, si vous avez un besoin légitime pour des traitements administratifs spécifiques, voici comment accorder les violons entre Nginx et PHP proprement selon la documentation officielle PHP-FPM.

Ajuster Nginx et PHP-FPM de façon chirurgicale

Dans la configuration de votre vhost Nginx (souvent sous /etc/nginx/sites-available/), il faut aligner la durée de lecture de la passerelle FastCGI :

location ~ \.php$ {
    include snippets/fastcgi-php.conf;
    fastcgi_pass unix:/run/php/php8.3-fpm.sock;
    
    # Éviter l'erreur 504 pour les opérations d'administration lourdes
    fastcgi_read_timeout 300s;
    fastcgi_send_timeout 300s;
}

Ensuite, dans votre php.ini ou votre pool PHP-FPM (/etc/php/8.3/fpm/pool.d/www.conf), vous devez impérativement coordonner la limite d’exécution PHP pour qu’elle corresponde :

max_execution_time = 300
request_terminate_timeout = 300s

Après modification, rechargez les daemons avec systemctl reload nginx php8.3-fpm. Si le proxy accorde 300 secondes et que PHP autorise 300 secondes, vous éliminez les 504 prématurées où le frontal coupait l’herbe sous le pied du script.

Déporter les traitements lourds pour ne plus jamais voir de code 504

Dans le monde du développement sérieux, exécuter une tâche de 3 minutes via une requête HTTP synchrone dans un navigateur est une mauvaise pratique. Le protocole HTTP est fait pour échanger des documents rapidement, pas pour migrer une base de données de 5 Go ou recalculer le stock de milliers de produits. Quand je conçois un plugin WordPress personnalisé ou une architecture pour une entreprise, j’applique deux règles d’or pour éradiquer définitivement l’erreur 504 wordpress.

WP-CLI : le couteau suisse des déploiements sans timeout

Pourquoi passer par l’interface web pour mettre à jour vos extensions ou votre coeur quand vous pouvez le faire directement en ligne de commande ? Avec l’outil officiel WP-CLI, la notion de timeout proxy n’existe tout simplement pas. Vous parlez directement à PHP en mode CLI (Command Line Interface), débarrassé de Nginx, de Cloudflare et des limitations de navigateur :

# Mettre à jour l'ensemble des extensions en toute sécurité
wp plugin update --all

# Mettre à jour la base de données WooCommerce après mise à jour majeure
wp wc update

# Régénérer les miniatures sans aucun blocage serveur
wp media regenerate --yes

Si la régénération des miniatures prend 25 minutes, elle tournera pendant 25 minutes sans sourciller. Pas de déconnexion réseau, pas d’angoisse de la page blanche. Tout s’affiche au fur et à mesure sur votre terminal avec une barre de progression claire.

Passer par l’asynchrone et les files d’attente

Si votre site réclame des imports réguliers ou des traitements volumineux, arrêtez d’attacher ces routines à des clics utilisateurs. WordPress intègre nativement l’Action Scheduler (le moteur utilisé par WooCommerce) pour découper les tâches massives en petits lots de quelques dizaines d’éléments exécutés par cron. Déconnectez le cron par défaut de WordPress (qui dépend des visites d’internautes) et branchez un vrai cron système au niveau de l’OS toutes les 5 minutes :

# Dans la crontab système (crontab -e)
*/5 * * * * /usr/bin/php /var/www/monsite/wp-cron.php >/dev/null 2>&1

Votre frontal HTTP reste ultra-rapide, vos pages se chargent en 200 millisecondes, et vos tâches lourdes tournent sereinement en tâche de fond sans jamais lever le moindre écran 504.

Foire Aux Questions (FAQ)

Quelle est la différence concrète entre une erreur 502 et une erreur 504 sur WordPress ?

L’erreur 502 Bad Gateway signifie que le serveur PHP-FPM a renvoyé une réponse invalide ou a tout simplement planté brutalement (par exemple un arrêt complet du service, une erreur de segmentation ou un manque de RAM avec crash du processus). L’erreur 504 Gateway Timeout indique que le serveur PHP fonctionne parfaitement, mais qu’il met beaucoup trop de temps à terminer son calcul, dépassant le délai de garde configuré sur le reverse proxy ou le CDN.

Mon site affiche « Indisponible pour maintenance », que faire après une 504 ?

Pendant une mise à jour, WordPress dépose un fichier temporaire nommé .maintenance à la racine du site (dans le même dossier que wp-config.php). Si le processus a rencontré un timeout avant d’avoir nettoyé ce verrou, le site reste figé sur ce message. Connectez-vous par SFTP ou via le gestionnaire de fichiers de votre hébergeur, vérifiez dans vos logs que la mise à jour est terminée, puis supprimez simplement ce fichier pour débloquer votre vitrine.

Est-ce que l’erreur 504 pénalise mon référencement naturel sur Google ?

Si l’erreur 504 arrive ponctuellement sur votre tableau de bord pendant un import, Googlebot ne la voit jamais, donc aucun impact. En revanche, si vos pages publiques renvoient des erreurs 504 lors des passages des robots d’indexation, Google considérera votre hébergement comme instable. S’il bute sur des codes 504 répétés pendant plusieurs jours, il ralentira son rythme de crawl avant de déclasser temporairement vos pages des résultats de recherche.

Cloudflare peut-il générer une erreur 504 tout seul ?

Oui. Cloudflare applique une limite stricte et non négociable de 100 secondes sur ses forfaits gratuits et professionnels pour toute réponse HTTP de votre serveur d’origine. Si une requête prend 101 secondes, vous recevrez une page 504 brandée Cloudflare, même si la configuration de votre Nginx autorise 300 secondes. Dans ce cas, la solution consiste à contourner le proxy pour les tâches d’administration ou à passer par la console WP-CLI.

Sebastien-Larrivee-v2.png

Sébastien Larrivée

Développeur - Rédacteur de contenu

iZyLiFy Conception Web, agence web oise

Je suis Sébastien Larrivée, développeur web sénior chez Nord-Image à Abbeville le jour, et freelance acharné la nuit. Concepteur d’applications, grand malade de SEO, accroc aux cryptos et collectionneur compulsif d’intelligences artificielles… Mais avant tout, je suis expert WordPress depuis plus de 10 ans. Ici, pas de blabla : je partage ce que je teste sur mes serveurs, j’aime quand le code est propre, quand c’est optimisé et surtout, quand ça ranke sur Google.

WordPress
SEO Technique
Développement Web
PHP
Table des matières
Generic selectors
Exact matches only
Search in title
Search in content
Post Type Selectors

Besoin
d'un site internet d'un site e-commerce de référencement naturel d'optimisation technique d'un audit ?

Chat avec Izy
1 Chat
izy ×
Fermer