Erreur 504 Prestashop : guide correction 2025 !

1. Quelles sont les causes principales de l’erreur 504 Gateway Timeout sur PrestaShop ?

L’erreur 504 apparaît lorsque le serveur met trop de temps à répondre à une requête, ce qui provoque un "timeout". Dans le contexte de PrestaShop, cela peut être dû à une surcharge du serveur, une requête SQL trop lourde ou un script qui boucle indéfiniment.

Cela se produit souvent sur les pages très complexes comme la commande, la mise à jour du catalogue ou la génération de PDF. Il faut analyser les performances serveur, vérifier les modules installés, et optimiser la base de données. Un hébergement trop lent ou surchargé est souvent en cause.

2. Pourquoi l’erreur 504 survient-elle souvent lors du passage en caisse sur PrestaShop ?

Le tunnel de commande est l’un des processus les plus lourds sur PrestaShop, car il implique le calcul des taxes, frais de livraison, stocks et paiements. Si le serveur est lent ou si un module de paiement met trop de temps à répondre, une erreur 504 peut survenir.

Il est recommandé de tester chaque étape du tunnel d’achat, désactiver temporairement les modules tiers (notamment ceux de livraison ou de paiement) et mesurer les temps de réponse. Si un module externe (comme une API bancaire) ralentit l’ensemble, envisagez une alternative ou contactez leur support.

3. Comment résoudre une erreur 504 après avoir activé un module sur PrestaShop ?

Certains modules, en particulier ceux qui traitent des données externes ou effectuent des calculs complexes, peuvent allonger considérablement le temps d’exécution. Lorsqu’un module ralentit trop le chargement d’une page, cela peut déclencher une erreur 504.

Pour identifier le module responsable, désactivez-les un par un via FTP ou depuis le back-office si encore accessible. Ensuite, testez les pages critiques. Si le problème disparaît après la désactivation d’un module, contactez son éditeur pour une mise à jour ou optimisez la configuration serveur pour compenser le traitement lourd.

4. Est-ce que l’hébergement peut être la cause d’une erreur 504 sur PrestaShop ?

Oui, l’hébergement est l’une des causes les plus fréquentes des erreurs 504. Un serveur mutualisé avec peu de ressources allouées, ou un serveur mal configuré, peut provoquer des délais de réponse trop longs.

Il est conseillé de vérifier les performances serveur (CPU, mémoire, trafic) via le panneau d’administration de l’hébergeur. Si les ressources sont constamment saturées, une montée en gamme vers un serveur dédié ou cloud plus performant peut être nécessaire. Les erreurs 504 récurrentes sont un signal que l’infrastructure actuelle est insuffisante.

5. Pourquoi une erreur 504 s’affiche-t-elle après une mise à jour de PrestaShop ?

Après une mise à jour, certaines fonctions internes peuvent devenir plus gourmandes, ou des modules anciens deviennent incompatibles, ralentissant les requêtes. Si le nouveau code nécessite plus de ressources que ce que le serveur peut fournir, il en résulte une erreur 504.

Il faut d’abord vérifier que tous les modules sont à jour et compatibles avec la nouvelle version de PrestaShop. Ensuite, optimiser la base de données, vider le cache, et désactiver les modules non essentiels. En dernier recours, ajuster les limites de temps d’exécution côté serveur peut aider.

6. Une erreur 504 peut-elle être causée par une mauvaise configuration du reverse proxy (Cloudflare, Nginx, etc.) ?

Oui, un reverse proxy comme Cloudflare ou Nginx peut être à l’origine d’une erreur 504 s’il attend une réponse trop longue du serveur d’origine. Cette erreur ne provient pas d’un plantage mais d’un délai dépassé entre les deux serveurs.

Il est important de vérifier les délais de timeout configurés dans l’interface de Cloudflare ou le fichier de configuration du proxy. Augmenter ces délais ou corriger les lenteurs côté serveur permet de résoudre le problème. Parfois, la désactivation temporaire du proxy peut confirmer son implication.

7. Pourquoi les pages produits provoquent-elles une erreur 504 sur certaines boutiques PrestaShop ?

Les pages produits peuvent générer une erreur 504 si elles contiennent des données très volumineuses (beaucoup d’attributs, déclinaisons, accessoires) ou si un module effectue des traitements complexes à chaque chargement.

Pour résoudre cela, il faut analyser les modules liés à la fiche produit, limiter les contenus chargés dynamiquement et optimiser les requêtes SQL éventuelles. La mise en cache des pages produits est également une solution efficace, tout comme l’optimisation des images et scripts pour accélérer le temps de chargement.

8. Comment prévenir les erreurs 504 sur PrestaShop sans changer d’hébergeur ?

Même sans changer d’hébergement, il est possible de prévenir les erreurs 504 en optimisant le site. Cela passe par la réduction du nombre de modules actifs, la suppression des modules inutilisés et la mise en cache des pages et requêtes les plus lourdes.

Une base de données bien structurée, indexée et nettoyée régulièrement améliore aussi la réactivité. Enfin, utiliser un CDN et optimiser les images peut réduire la charge sur le serveur, ce qui limite le risque de dépassement de délai d’exécution.

9. Les erreurs 504 peuvent-elles affecter uniquement l’administration PrestaShop ?

Oui, l’administration peut aussi être victime d’une erreur 504, notamment lors de l’accès à des sections lourdes comme les statistiques, la génération de rapports ou les listes de produits très longues. Les modules du tableau de bord peuvent ralentir considérablement ces pages.

Il est recommandé de désactiver temporairement les widgets non essentiels du back-office et de limiter le nombre d’éléments affichés par page. Si l’erreur persiste, un audit des performances côté serveur et base de données est nécessaire pour cibler l’origine du ralentissement.

10. Comment surveiller et analyser les erreurs 504 de manière proactive sur PrestaShop ?

Pour surveiller les erreurs 504, il est conseillé d’utiliser des outils comme Google Search Console, des moniteurs de disponibilité ou les journaux d’accès du serveur. Ces outils permettent de repérer les périodes où les temps de réponse dépassent la normale.

En analysant ces données, on peut identifier les pages ou les actions qui causent les ralentissements. Couplé à des outils de performance comme New Relic ou Blackfire, cela permet de repérer les goulets d’étranglement dans le code ou les requêtes SQL, et de les corriger avant que les clients ne soient impactés.