Quelles sont les 10 erreurs et solutions 500 Prestashop ?

tableau comparatif des 10 erreurs 500 les plus fréquentes dans PrestaShop

1. Erreur 500 PrestaShop causée par un module incompatible : comment désactiver un module via FTP ou base de données

L’une des causes les plus fréquentes d’une erreur 500 sur PrestaShop est l’installation d’un module incompatible ou mal codé. Cela peut arriver après une mise à jour PrestaShop, ou suite à l’ajout d’un module tiers non certifié. Dans ce cas, l’administration et le front-office deviennent inaccessibles.

Pour corriger le problème, connectez-vous en FTP, accédez au dossier /modules, puis renommez le dossier du module en question. Vous pouvez aussi le désactiver via phpMyAdmin en modifiant la table ps_module. Une fois désactivé, videz le cache du site pour restaurer l’accès.

2. Erreur 500 PrestaShop due à un fichier .htaccess mal configuré : comment régénérer un .htaccess valide

Un fichier .htaccess corrompu, mal écrit ou trop restrictif peut générer une erreur 500. Cela se produit souvent après une migration, une activation incorrecte des URLs réécrites ou un ajout manuel d’instructions dans ce fichier critique.

Pour corriger cette erreur, supprimez temporairement le fichier .htaccess via FTP, puis connectez-vous au back-office (si possible) et allez dans Paramètres de la boutique > Trafic & SEO, puis cliquez sur "Enregistrer" pour le régénérer. Sinon, créez un fichier de base contenant les règles standards de PrestaShop adaptées à votre version.

3. Erreur 500 après mise à jour de PHP : comment corriger une incompatibilité entre PrestaShop et la version PHP

Une mise à jour du serveur vers une version PHP non supportée par votre version de PrestaShop peut provoquer une erreur 500 immédiate. Les fonctions obsolètes ou supprimées (ex. mysql_connect) ne sont plus reconnues, entraînant un plantage du site.

La solution consiste à vérifier la version PHP recommandée pour votre version de PrestaShop (par exemple PHP 7.4 ou 8.1). Accédez à votre hébergeur (Plesk, cPanel…) et rétrogradez vers une version compatible. Ensuite, testez votre boutique avec le mode debug activé pour détecter d’autres incompatibilités éventuelles.

4. Erreur 500 PrestaShop liée au manque de mémoire PHP : comment augmenter le memory_limit

Un manque de mémoire PHP provoque souvent une erreur 500 lors du chargement de pages complexes (panier, commande, back-office). Par défaut, de nombreux serveurs limitent la mémoire à 128 Mo, ce qui peut être insuffisant pour PrestaShop et ses modules.

Pour résoudre le problème, augmentez la mémoire disponible en modifiant le fichier php.ini (ajoutez memory_limit = 512M), .htaccess (avec php_value memory_limit 512M), ou le fichier config.ini de votre hébergeur. Une fois la limite relevée, videz le cache pour appliquer les changements. Cela stabilisera les performances de votre boutique.

5. Erreur 500 causée par un override corrompu dans PrestaShop : comment identifier et désactiver un override problématique

Les fichiers override permettent de personnaliser le comportement de PrestaShop, mais une erreur dans leur code peut bloquer tout le site. Une faute de syntaxe, une classe mal étendue ou une incompatibilité avec la version actuelle peut provoquer une erreur 500.

La première étape est de renommer le dossier /override/ temporairement via FTP, puis vider le cache. Si le site fonctionne à nouveau, vous savez que l’erreur vient de là. Pour corriger définitivement, analysez chaque fichier override concerné avec un développeur ou restaurez les fichiers d’origine.

6. Erreur 500 sur PrestaShop à cause d’un thème mal codé : comment activer le mode debug et localiser l’erreur

Un fichier .tpl mal codé (balise non fermée, variable absente) dans votre thème peut causer une erreur 500 dès que la page tente de se charger. Ce type d’erreur est difficile à repérer sans activer les messages d’erreur.

Activez le mode debug dans le fichier /config/defines.inc.php en remplaçant false par true à la ligne define('_PS_MODE_DEV_', true);. Rechargez la page pour voir les messages d’erreur détaillés. Le message vous indiquera le fichier précis à corriger. Une fois modifié, désactivez le mode debug pour repasser en production.

7. Erreur 500 liée au cache PrestaShop corrompu : comment supprimer manuellement les fichiers de cache

Un cache mal généré peut entraîner une erreur 500, surtout après l’installation d’un module ou une mise à jour. Cela peut bloquer aussi bien le front-office que le back-office, sans message d’erreur clair.

Pour corriger cela, connectez-vous en FTP et supprimez manuellement le contenu des dossiers suivants :

• /var/cache/prod/ (ou /var/cache/dev/ si le mode dev est actif),

• /cache/smarty/compile/,

• /cache/smarty/cache/.

Ces dossiers seront automatiquement régénérés au prochain chargement du site. Cela permet souvent de rétablir l’accès au site en quelques secondes.

8. Erreur 500 lors de la connexion à la base de données PrestaShop : comment vérifier les identifiants MySQL

Une erreur 500 peut apparaître si PrestaShop ne parvient pas à se connecter à la base de données. Cela se produit si les identifiants dans app/config/parameters.php sont erronés, ou si le serveur MySQL est temporairement inaccessible.

Connectez-vous en FTP et ouvrez le fichier parameters.php. Vérifiez les champs database_host, database_name, database_user, et database_password. Testez aussi la connexion MySQL via un outil comme phpMyAdmin. Si les informations sont incorrectes, corrigez-les et rechargez la page. En cas de migration récente, vérifiez également que le nom d’hôte (souvent localhost) est correct.

9. Erreur 500 après suppression d’un module PrestaShop : comment nettoyer les hooks et appels résiduels

La désinstallation incomplète d’un module peut laisser des hooks ou fichiers actifs dans le thème qui appellent des fonctions désormais inexistantes. Cela génère une erreur 500 dès que la page tente d'exécuter une fonction supprimée.

Utilisez le mode debug pour identifier les fichiers problématiques. Ensuite, éditez votre thème (header, footer, product.tpl…) et supprimez les appels aux fonctions du module désinstallé. Un module comme PrestaShop Cleaner peut également supprimer les entrées en base de données laissées par des modules désinstallés.

10. Erreur 500 PrestaShop à cause d’un problème de permissions sur les fichiers ou dossiers : comment les corriger

Des permissions incorrectes sur les fichiers (ex. : 777 ou 600) peuvent empêcher le serveur d’exécuter certaines ressources, déclenchant une erreur 500. Cela se produit souvent après un transfert FTP mal configuré ou un changement d’hébergeur.

Pour corriger les permissions, utilisez votre client FTP ou un accès SSH. Les dossiers doivent avoir des permissions 755, et les fichiers 644. Ne laissez jamais de fichiers en 777, car cela peut aussi poser un risque de sécurité. Une fois les permissions corrigées, videz le cache pour tester si le problème est résolu.