---
title: "Dépannage Drupal : trouver la cause, pas seulement vider le cache"
description: "« The website encountered an unexpected error », écran blanc, mise à jour interrompue, Composer qui refuse de s’installer : NEWP diagnostique votre site Drupal gratuitement, puis le répare sur devis, à distance. Pourquoi un site Drupal tombe en panne Un site Drupal moderne (Drupal 8 à 11) n’est pas un ensemble de fichiers que l’on copie : c’est […]"
url: "https://www.newp.fr/depannage-drupal/"
author: "Kévin Papot"
date: "2026-10-16T12:15:50+00:00"
modified: "2026-10-16T13:33:12+00:00"
lang: "fr_FR"
---

# Dépannage Drupal : trouver la cause, pas seulement vider le cache

« The website encountered an unexpected error », écran blanc, mise à jour interrompue, Composer qui refuse de s’installer : NEWP diagnostique votre site Drupal gratuitement, puis le répare sur devis, à distance.

## Pourquoi un site Drupal tombe en panne

Un site Drupal moderne (Drupal 8 à 11) n’est pas un ensemble de fichiers que l’on copie : c’est un projet **Composer**, avec un fichier `composer.lock` qui fige les versions du cœur, des modules et des bibliothèques Symfony, une configuration exportée en YAML et une base qui doit correspondre à ce code. La plupart des pannes naissent d’un décalage entre ces trois éléments : du code mis à jour sans lancer les mises à jour de base, une configuration importée d’un autre environnement, une version de PHP changée par l’hébergeur.

Le message affiché ne dit presque rien. En production, Drupal masque les erreurs et se contente de « The website encountered an unexpected error. Try again later. » La vraie cause se trouve dans le journal (*Rapports > Messages récents*, ou `drush watchdog:show`), dans les journaux PHP du serveur, ou en activant temporairement l’affichage détaillé avec `$config[’system.logging’][’error_level’] = ’verbose’;` dans un `settings.local.php`. Vider le cache (`drush cr`) règle certains cas, mais masque souvent le vrai problème.

NEWP dépanne Drupal 7, 10 et 11 à distance partout en France, avec la même règle que sur tous nos dépannages : **diagnostic offert**, devis avant toute intervention, réparation sur une copie quand c’est possible. Si le site montre des signes d’intrusion (comptes inconnus, spam, redirections), voyez notre page [site Drupal piraté](/drupal-pirate/). Pour éviter que les pannes se répètent, la [maintenance Drupal](/maintenance-drupal/) encadre les mises à jour.

## Les trois familles de pannes Drupal

Presque tous nos dépannages Drupal entrent dans l’une de ces catégories.

### Mise à jour à moitié faite

Code à jour mais base pas encore : erreurs de table ou de colonne manquante. La commande `drush updatedb` (ou la page `update.php`) n’a pas été lancée, ou s’est arrêtée en cours. Un message `SQLSTATE[42S22]: Column not found` ou `Base table or view not found` en est le signe typique.

### Composer bloqué

« Your requirements could not be resolved to an installable set of packages. » Un module exige une version de Drupal ou de PHP différente, un patch ne s’applique plus, ou la mémoire manque. Relancer au hasard `composer update` sur la production aggrave souvent la situation.

### Environnement modifié

L’hébergeur a changé PHP, le domaine a changé, la base a été déplacée. « The provided host name is not valid for this server » vient de `trusted_host_patterns`, une erreur `SQLSTATE[HY000] [2002]` d’une connexion à la base refusée, et `Allowed memory size exhausted` d’une limite mémoire trop basse.

## Ce que comprend notre dépannage Drupal

Après le diagnostic offert, le devis précise la réparation. Nos interventions courantes :

### Lecture des journaux

Journal Drupal, journaux PHP et serveur, rapport d’état (*Rapports > Rapport d’état*) pour identifier la cause exacte avant de toucher au site.

### Mises à jour de base terminées

Reprise de `drush updatedb`, correction des mises à jour qui échouent, vérification des schémas de modules.

### Composer remis d’aplomb

Analyse du `composer.json` et du `composer.lock`, patches, contraintes de version, puis installation reproductible avec `composer install`.

### Configuration et environnement

`settings.php`, `trusted_host_patterns`, connexion à la base, version de PHP compatible avec la version de Drupal, synchronisation de la configuration.

### Modules et thème

Module en conflit, module abandonné incompatible avec Drupal 11, thème personnalisé à corriger après une montée de version.

### Accès perdus

Lien de connexion à usage unique avec `drush user:login`, récupération des accès à l’hébergement et au dépôt de code.

## Messages d’erreur Drupal fréquents

| Message ou symptôme | Cause fréquente | Premier geste sans risque |
|---|---|---|
| « The website encountered an unexpected error » | Exception PHP masquée en production | Lire Rapports > Messages récents ou les journaux PHP |
| Écran blanc, aucune page | Erreur fatale PHP, mémoire épuisée | Consulter le journal d’erreurs de l’hébergeur |
| « The provided host name is not valid for this server » | Domaine absent de `trusted_host_patterns` | Vérifier `settings.php` sans le modifier en production |
| `SQLSTATE[HY000] [2002]` | Base injoignable ou identifiants changés | Vérifier l’état de la base chez l’hébergeur |
| « Column not found » après une mise à jour | Mises à jour de base non appliquées | Sauvegarder la base avant de relancer quoi que ce soit |
| Composer : « requirements could not be resolved » | Contrainte de version ou de PHP incompatible | Ne pas lancer de mise à jour globale en production |

Dans tous les cas, une sauvegarde de la base et des fichiers avant la moindre commande reste le premier réflexe : une mise à jour de base relancée sur une base abîmée peut rendre la situation irréversible.

## Version de Drupal : le contexte change le dépannage

La même erreur ne se traite pas de la même façon sur Drupal 7 et sur Drupal 11.

### Drupal 7

Fin de vie depuis le 5 janvier 2025. Pas de Composer dans la plupart des cas, des modules souvent abandonnés et des incompatibilités croissantes avec les versions récentes de PHP. Le dépannage remet le site en ligne ; il ne règle pas la question de son avenir.

### Drupal 10

Fin de support le 9 décembre 2026. Un dépannage est l’occasion de repérer les modules qui bloqueront la [migration vers Drupal 11](/migration-drupal-11/).

### Drupal 11

Version actuelle. Les pannes viennent surtout de Composer, des modules contribués et de l’environnement serveur.

### Mode maintenance

Activable dans *Configuration > Développement > Mode de maintenance* ou en ligne de commande, il protège les visiteurs pendant la réparation. Il ne remplace pas une copie de travail.

## Comment se déroule un dépannage Drupal

1. **Diagnostic offert.** Accès, journaux et version : nous identifions la cause et l’étendue de la panne, sans rien modifier.
2. **Devis avant intervention.** Réparation décrite, durée estimée, risques éventuels. Rien n’est engagé sans votre accord.
3. **Sauvegarde et copie de travail.** Copie des fichiers et de la base, réparation sur une copie lorsque l’hébergement le permet.
4. **Réparation et tests.** Correction de la cause, mises à jour de base, cache reconstruit, test des pages clés, des formulaires et des accès.
5. **Compte rendu.** Ce qui a été fait, pourquoi la panne s’est produite et ce qu’il faut prévoir pour qu’elle ne revienne pas.

## Questions fréquentes

### Que signifie « The website encountered an unexpected error » sur Drupal ?

C’est le message générique affiché quand une exception PHP survient en production. Il ne donne pas la cause, qui se lit dans *Rapports > Messages récents*, avec `drush watchdog:show` ou dans les journaux PHP. Le **diagnostic est offert** pour la trouver.

### Vider le cache Drupal suffit-il à réparer le site ?

Parfois, quand un service ou un chemin a changé. `drush cr` reconstruit le cache sur Drupal 8 et plus, `drush cc all` sur Drupal 7. Si l’erreur revient, la cause est ailleurs : mise à jour de base, module, configuration ou environnement.

### Ma mise à jour Drupal s’est arrêtée en cours, que faire ?

Ne relancez pas tout de suite. Sauvegardez la base, notez le message affiché, puis vérifiez quelles mises à jour restent en attente avec `drush updatedb:status`. Une mise à jour relancée sur une base à moitié migrée peut aggraver les dégâts.

### Composer refuse de mettre à jour mon Drupal, pourquoi ?

Souvent parce qu’un module exige une autre version de Drupal ou de PHP, qu’un patch ne s’applique plus, ou que la mémoire allouée à Composer est insuffisante. La solution passe par l’analyse des contraintes, pas par la suppression du `composer.lock`.

### Mon site Drupal 7 est en panne, faut-il le migrer ?

Pas dans l’urgence : on le remet d’abord en ligne. Mais Drupal 7 ne reçoit plus de correctifs officiels depuis janvier 2025, et chaque panne liée à PHP risque de revenir. Nous présentons les options, dont la [migration vers Drupal 11](/migration-drupal-11/), avec leurs critères de décision.

### Combien coûte un dépannage Drupal ?

Le prix dépend de la cause et du temps nécessaire : un paramètre à corriger n’a rien à voir avec un projet Composer à reconstruire. Il est fixé sur devis après le diagnostic offert. Pour une vue d’ensemble des urgences, voir [urgence site internet](/urgence-site-internet/).

## Pour aller plus loin

- [Urgence site internet](/urgence-site-internet/)
- [Site Drupal piraté](/drupal-pirate/)
- [Maintenance Drupal](/maintenance-drupal/)
- [Migration Drupal 11](/migration-drupal-11/)
- [Agence Drupal](/agence-drupal/)
- [Agence SEO Drupal](/agence-seo-drupal/)
- [Consultant SEO Drupal](/consultant-seo/drupal/)
- [Infogérance de site web](/infogerance-site-web/)
- [TMA site web](/tma-site-web/)

---

*Source : [www.newp.fr](https://www.newp.fr/depannage-drupal/)*
