Depannage PrestaShop : 10 Problemes Courants et Leurs Solutions

Votre boutique PrestaShop ne repond plus, affiche une page blanche ou une erreur 500 ? Pas de panique. La plupart des pannes PrestaShop ont des causes identifiables et des solutions connues.

Ce guide couvre les 10 problemes les plus frequents que nous rencontrons en intervention, avec pour chacun un diagnostic precis et une solution applicable immediatement. Si vous n’etes pas a l’aise avec les manipulations techniques, Cyberial intervient 7j/7 pour le depannage urgent de votre boutique.

Avant de commencer : activez le mode debug

Avant tout depannage, activez le mode debug de PrestaShop pour voir les erreurs exactes au lieu d’une page blanche ou d’un message generique.

Sur PrestaShop 1.7 / 8 :

Ouvrez le fichier config/defines.inc.php et modifiez :

define('_PS_MODE_DEV_', true);

Sur PrestaShop 1.6 :

Meme fichier, meme ligne. Passez la valeur a true.

Une fois active, PrestaShop affichera les erreurs PHP detaillees directement sur la page. C’est la premiere etape de tout diagnostic.

Important : pensez a desactiver le mode debug une fois le probleme resolu. Laisser le debug actif en production expose des informations sensibles.

Les 10 problemes les plus courants

1. Page blanche (White Screen of Death)

La page blanche est le probleme le plus stressant : aucun message d’erreur, juste un ecran vide.

Causes frequentes :

• Module incompatible avec votre version de PrestaShop
• Erreur PHP fatale (syntaxe, classe manquante)
• Memoire PHP insuffisante

Solutions :

1. Activez le mode debug (voir ci-dessus). Dans la majorite des cas, l’erreur exacte apparaitra.
2. Si le debug ne suffit pas, consultez les logs PHP de votre serveur : var/logs/ sur PrestaShop 1.7+ ou les logs Apache/Nginx.
3. Si le probleme est apparu apres l’installation d’un module, desactivez-le via FTP en renommant son dossier dans modules/ (ex: modules/monmodule en modules/monmodule_disabled).
4. Augmentez la memoire PHP dans votre php.ini : memory_limit = 256M.

2. Erreur 500 (Internal Server Error)

L’erreur 500 indique un probleme cote serveur. PrestaShop ne peut pas traiter la requete.

Causes frequentes :

• Fichier .htaccess corrompu ou mal configure
• Permissions de fichiers incorrectes
• Version PHP incompatible
• Module defaillant

Solutions :

1. Verifiez le .htaccess : renommez-le temporairement en .htaccess_backup. Si le site fonctionne, regenerez-le depuis le back-office (Parametres de la boutique > Trafic et SEO > cochez “URL simplifiees” et sauvegardez).
2. Verifiez les permissions : les dossiers doivent etre en 755, les fichiers en 644. Commande : find . -type d -exec chmod 755 {} \; et find . -type f -exec chmod 644 {} \;.
3. Verifiez la version PHP : PrestaShop 1.7 requiert PHP 7.1+, PrestaShop 8 requiert PHP 7.2.5+. Verifiez dans votre panneau d’hebergement.
4. Consultez les logs serveur : les error logs Apache ou Nginx donnent la cause exacte.

3. Back-office inaccessible

Vous ne pouvez plus acceder a l’administration de votre boutique. Le front-office fonctionne parfois encore.

Causes frequentes :

• Module d’administration defaillant
• Cache corrompu
• Session PHP expiree ou corrompue

Solutions :

1. Videz le cache manuellement via FTP : supprimez tout le contenu de var/cache/prod/ et var/cache/dev/ (PrestaShop 1.7+). Pour en savoir plus, consultez notre guide pour vider le cache PrestaShop via FTP.
2. Desactivez un module suspect via la base de donnees : dans la table ps_module, passez active a 0 pour le module en question.
3. Renommez le dossier admin : si l’URL de votre admin a ete modifiee, verifiez le nom du dossier d’administration sur votre serveur FTP.
4. Reintialisez votre mot de passe via phpMyAdmin dans la table ps_employee (le mot de passe est un hash MD5 sur PS 1.6, ou bcrypt sur PS 1.7+).

4. Site tres lent

Un site qui met plus de 3 secondes a charger perd des visiteurs et des ventes.

Causes frequentes :

• Cache PrestaShop desactive
• Trop de modules actifs
• Hebergement sous-dimensionne
• Images non optimisees

Solutions :

1. Activez le cache Smarty : Back-office > Parametres avances > Performance. Activez le cache et la compilation de templates.
2. Desactivez les modules inutilises : chaque module charge du code. Desactivez ceux que vous n’utilisez pas activement.
3. Activez un CDN comme Cloudflare : il met en cache vos ressources statiques sur des serveurs proches de vos visiteurs. Consultez notre guide Cloudflare avec PrestaShop.
4. Optimisez vos images : utilisez un outil comme TinyPNG ou un module de compression d’images.
5. Videz le cache OVH regulierement si vous etes heberge chez OVH. Suivez notre guide pour vider le cache PrestaShop sur OVH.

5. Probleme de base de donnees

Erreurs MySQL, tables corrompues, ou requetes qui timeout : les problemes de base de donnees peuvent rendre le site inutilisable.

Causes frequentes :

• Tables corrompues apres un crash serveur
• Base de donnees saturee (logs, paniers abandonnes, anciens ordres)
• Index manquants

Solutions :

1. Reparation des tables via phpMyAdmin : selectionnez les tables corrompues, puis “Reparer la table”.
2. Nettoyez les donnees inutiles : supprimez les anciens paniers (ps_cart de plus de 3 mois), les logs (ps_log), les connexions (ps_connections, ps_connections_page).
3. Optimisez les tables : dans phpMyAdmin, selectionnez toutes les tables puis “Optimiser”.

Pour un guide complet, consultez notre article sur comment reparer une base de donnees PrestaShop en toute securite.

6. Module qui fait planter le site

Vous installez ou mettez a jour un module et le site plante immediatement.

Causes frequentes :

• Module incompatible avec votre version de PrestaShop
• Conflit entre deux modules utilisant les memes hooks
• Module mal code (erreur PHP)

Solutions :

1. Desactivez le module via FTP : renommez son dossier dans modules/. Le site reprendra immediatement.
2. Si le back-office est inaccessible, desactivez le module via la base de donnees : dans ps_module, mettez active = 0 pour le module concerne.
3. Verifiez la compatibilite avant d’installer un module : la fiche Addons indique les versions PrestaShop supportees.
4. Testez toujours sur un environnement de staging avant de deployer en production.

7. Probleme SSL / HTTPS

Cadenas absent, alertes de securite, ou contenu mixte : les problemes SSL font fuir les clients et degradent le referencement.

Causes frequentes :

• Certificat SSL expire
• Contenu mixte (ressources HTTP sur une page HTTPS)
• Configuration PrestaShop incorrecte (URL en HTTP dans les parametres)

Solutions :

1. Renouvelez votre certificat depuis votre panneau d’hebergement. La plupart des hebergeurs proposent Let’s Encrypt gratuitement.
2. Forcez le HTTPS dans PrestaShop : Back-office > Parametres de la boutique > Parametres generaux > cochez “Activer SSL” et “Activer SSL partout”.
3. Corrigez le contenu mixte : cherchez les URLs en http:// dans votre theme et vos modules. Remplacez-les par https:// ou par // (protocol-relative).
4. Mettez a jour les URLs dans la table ps_configuration : verifiez PS_SHOP_DOMAIN et PS_SHOP_DOMAIN_SSL.

8. Theme casse apres une mise a jour

Apres une mise a jour de PrestaShop ou du theme, le front-office est deforme ou des fonctionnalites ne marchent plus.

Causes frequentes :

• Surcharges (overrides) incompatibles avec la nouvelle version
• Fichiers de theme modifies directement (au lieu d’utiliser un theme enfant)
• Cache non vide apres la mise a jour

Solutions :

1. Videz tous les caches : cache Smarty, cache du navigateur, cache du CDN si applicable.
2. Verifiez les overrides dans le dossier override/. Comparez-les avec les fichiers originaux de la nouvelle version.
3. Restaurez le theme par defaut temporairement pour confirmer que le probleme vient du theme custom.
4. Si le probleme persiste, restaurez votre backup. C’est pourquoi il est essentiel de toujours faire un backup avant toute mise a jour. Consultez notre guide pourquoi faire un backup avant une maintenance.

9. Emails qui ne partent plus

Les confirmations de commande, les emails de contact ou les notifications ne sont plus envoyes.

Causes frequentes :

• Configuration SMTP incorrecte
• Serveur de mail blackliste
• Limite d’envoi atteinte chez l’hebergeur

Solutions :

1. Verifiez la configuration email : Back-office > Parametres avances > E-mail. Testez l’envoi avec le bouton “Tester la configuration email”.
2. Utilisez un SMTP externe comme Brevo (ex-Sendinblue), Mailgun ou Amazon SES. C’est plus fiable que le mail du serveur.
3. Verifiez les logs email dans le back-office : Back-office > Parametres avances > E-mail > onglet “Journal”.
4. Verifiez votre domaine : assurez-vous que les enregistrements SPF, DKIM et DMARC sont correctement configures dans votre DNS.

10. Site hacke ou pirate

Redirections suspectes, pages modifiees, fichiers inconnus : votre site a ete compromis.

Causes frequentes :

• Modules avec des failles de securite connues
• Version de PrestaShop obsolete
• Mot de passe admin faible
• Acces FTP non securise

Solutions :

1. Mettez le site en maintenance immediatement pour proteger vos clients.
2. Changez tous les mots de passe : admin PrestaShop, FTP, base de donnees, panneau hebergement.
3. Scannez les fichiers : cherchez les fichiers modifies recemment avec find . -mtime -7 -type f. Comparez avec une installation propre de PrestaShop.
4. Supprimez les fichiers suspects et restaurez les fichiers originaux de PrestaShop.
5. Mettez a jour PrestaShop et tous les modules a leurs dernieres versions.

Pour mieux comprendre les failles courantes, consultez notre article sur les failles de securite sur un site PrestaShop.

En cas de piratage, nous recommandons fortement de faire appel a un professionnel. Les hackers laissent souvent des backdoors que seul un expert peut detecter. Cyberial intervient en urgence 7j/7 pour le nettoyage et la securisation de votre boutique.

Quand faire appel a un professionnel

Certains problemes se resolvent en quelques minutes. D’autres necessitent une expertise technique approfondie. Faites appel a un professionnel si :

• Le probleme persiste apres avoir suivi les etapes ci-dessus
• Vous n’avez pas acces au serveur (FTP, phpMyAdmin)
• Votre site a ete hacke et vous n’etes pas sur de l’etendue de la compromission
• Vous avez perdu des donnees et n’avez pas de backup recent
• Votre activite depend du site et chaque heure d’indisponibilite vous coute des ventes

Notre equipe chez Cyberial est specialisee dans le depannage PrestaShop. Agence certifiee, nous intervenons 7j/7 pour remettre votre boutique en ligne le plus rapidement possible. Du diagnostic a la resolution, nous prenons en charge l’ensemble du processus.

Prevenir plutot que guerir

La meilleure facon d’eviter les pannes est de maintenir votre site regulierement :

• Mises a jour : appliquez les patchs de securite et mises a jour de modules des qu’ils sont disponibles
• Backups automatiques : programmez un backup quotidien de votre base de donnees et de vos fichiers
• Monitoring : mettez en place une surveillance de la disponibilite de votre site (UptimeRobot, par exemple)
• Cache : videz le cache regulierement pour eviter les problemes de performance

Pour un guide complet, consultez notre article sur la maintenance pour un site web PrestaShop.

Questions frequentes

Que faire quand mon site PrestaShop est en panne ?

La premiere etape est d’activer le mode debug en passant _PS_MODE_DEV_ a true dans config/defines.inc.php. Cela affichera l’erreur exacte. Ensuite, identifiez la cause parmi les 10 problemes courants listes dans ce guide. Si le probleme depasse vos competences techniques, contactez une agence specialisee comme Cyberial pour un depannage urgent.

Combien coute un depannage PrestaShop ?

Le cout depend de la complexite du probleme. Un probleme simple (cache, module a desactiver) peut se resoudre en 30 minutes. Un piratage complet ou une migration de version peut prendre plusieurs jours. Chez Cyberial, nous proposons un diagnostic initial pour evaluer la situation avant toute intervention. Demandez un devis gratuit.

Comment activer le mode debug sur PrestaShop ?

Ouvrez le fichier config/defines.inc.php a la racine de votre installation PrestaShop. Cherchez la ligne define('_PS_MODE_DEV_', false); et remplacez false par true. Sauvegardez et rechargez la page. Les erreurs PHP s’afficheront directement. N’oubliez pas de remettre false une fois le probleme resolu.

Peut-on depanner PrestaShop sans acces au back-office ?

Oui. La plupart des operations de depannage peuvent se faire via FTP (pour modifier des fichiers, desactiver des modules) et phpMyAdmin (pour modifier la base de donnees, reinitialiser un mot de passe, desactiver un module). C’est d’ailleurs souvent la seule option quand le back-office est inaccessible.

Besoin d’aide avec votre site PrestaShop ? Cyberial est une agence PrestaShop certifiée spécialisée en maintenance et dépannage 7j/7. Découvrir nos services