# « Le thème actif est introuvable » après restauration : récupérer sans perdre les réglages

> Une sauvegarde incomplète restaure la base de données mais oublie le dossier du thème. Procédure de récupération qui préserve les réglages personnalisés déjà enregistrés.

- Auteur : WordPress Développement
- Publié le : 2023-12-30
- Mis à jour le : 2023-12-30
- Catégorie : Thèmes
- URL : https://www.wpmoderne.fr/themes/theme-actif-introuvable-restauration-sauvegarde/

## L’essentiel

- L'erreur vient d'une base restaurée sans les fichiers du thème correspondants
- wp_options garde la trace du thème attendu même quand le dossier a disparu
- La récupération n'exige pas de tout recommencer depuis zéro

« The active theme is broken. Reverting to the default theme » ou, en français, « Le thème actif est introuvable » : ce message apparaît en haut de l'administration WordPress juste après une restauration de sauvegarde, généralement suivi d'un site affiché avec le thème par défaut installé, Twenty Twenty-Three ou équivalent, plutôt qu'avec le thème habituel du site.

Ce cas très concret survient lorsqu'une sauvegarde restaure correctement la base de données, mais que les fichiers du dossier `wp-content/themes/` n'ont pas suivi — sauvegarde partielle, script de migration mal configuré, ou restauration effectuée depuis deux sources différentes (base d'un côté, fichiers d'un autre) qui ne correspondent pas exactement.

## Où WordPress mémorise le thème actif

Trois emplacements distincts conservent une trace du thème censé être actif, et il faut les vérifier dans cet ordre pour poser un diagnostic complet :

1. L'option `template` dans `wp_options`, qui référence le dossier du thème parent
2. L'option `stylesheet` dans `wp_options`, qui référence le dossier réellement actif (thème enfant le cas échéant)
3. Le contenu physique du dossier `wp-content/themes/` sur le serveur

Une requête directe confirme rapidement ce que la base attend :

```
wp option get template
wp option get stylesheet
```

Si ces deux commandes renvoient, par exemple, `astra` et `astra-enfant-client`, mais que `ls wp-content/themes/` ne montre ni l'un ni l'autre dossier, le diagnostic est confirmé : la base attend un thème dont les fichiers ont disparu du serveur.

> L'essentiel à retenir : L'erreur vient d'une base restaurée sans les fichiers du thème correspondants ; wp_options garde la trace du thème attendu même quand le dossier a disparu ; La récupération n'exige pas de tout recommencer depuis zéro

## Procédure de récupération, étape par étape

La bonne nouvelle : tant que la base de données reste intacte, tous les réglages personnalisés du thème — Customizer, menus, widgets, options enregistrées par le thème — restent stockés dans `wp_options` et dans les tables associées, même si WordPress affiche temporairement le thème par défaut. Restaurer le bon dossier de thème suffit à tout récupérer sans perte.

1. Identifier précisément le nom du thème attendu via `wp option get stylesheet`, et le thème parent via `wp option get template` s'ils diffèrent
2. Récupérer les fichiers du thème depuis la source la plus fiable disponible : sauvegarde de fichiers antérieure, dépôt Git du projet, ou export du thème depuis un environnement de recette à jour
3. Déposer le dossier récupéré dans `wp-content/themes/`, en respectant exactement le nom de dossier attendu par `stylesheet`
4. Vérifier les permissions du dossier (généralement 755 pour les répertoires, 644 pour les fichiers) pour éviter un nouvel écran d'erreur lié à des droits insuffisants
5. Recharger l'administration : le message d'erreur doit disparaître dès que WordPress retrouve un dossier de thème correspondant au nom attendu

## Si aucune copie du thème n'est disponible

Dans le cas, plus délicat, où le dossier du thème est réellement perdu sans copie de secours — thème premium acheté une seule fois sans conserver l'archive, par exemple — deux options restent ouvertes avant de renoncer aux réglages enregistrés :

- Recontacter l'auteur du thème premium pour récupérer une nouvelle copie de licence, la plupart des marketplaces conservant un historique de téléchargement
- Recréer un dossier de thème minimal portant exactement le même nom (`style.css` avec l'en-tête correspondant, `index.php` vide), le temps de basculer proprement vers un thème de remplacement sans perdre l'accès à l'administration entre-temps

Cette seconde option ne restaure évidemment pas l'apparence du site, mais elle rétablit un accès stable à l'administration, le temps de reconstruire une solution durable — souvent une migration planifiée vers un nouveau thème plutôt qu'une simple restauration.

## Vérification finale : les widgets et menus n'ont pas bougé

Une fois le thème restauré, un contrôle rapide s'impose sur les zones de widgets et les emplacements de menu, car WordPress associe ces éléments à des identifiants de zone (`sidebar-1`, `menu-principal`) déclarés par le thème lui-même. Si le dossier restauré correspond à une version légèrement différente du thème, ayant renommé une zone de widget entre-temps, certains contenus peuvent apparaître « orphelins » dans l'écran Widgets, sans disparaître de la base pour autant.

> Un thème introuvable n'efface jamais les réglages enregistrés dans la base ; il les rend seulement invisibles tant que le bon dossier n'est pas retrouvé.

## Prévention pour la prochaine sauvegarde

Ce type d'incident souligne l'intérêt de vérifier, lors de tout audit de stratégie de sauvegarde, que fichiers et base de données sont bien sauvegardés selon un calendrier cohérent et, idéalement, dans une même archive horodatée, plutôt que par deux mécanismes indépendants susceptibles de dériver l'un de l'autre au fil du temps.

## En résumé

Le message « thème actif introuvable » n'est presque jamais synonyme de perte de données : c'est un simple décalage entre ce que la base de données attend et ce qui existe réellement sur le serveur. Restaurer le bon dossier au bon endroit, avec le nom exact attendu par `stylesheet`, suffit dans l'immense majorité des cas à retrouver un site identique à son état d'avant incident, réglages compris.
