Introduction
Une erreur de manifeste Odoo survient quand le fichier __manifest__.py d’un module contient une anomalie. Ce petit fichier central décrit les métadonnées du module, ses dépendances, les fichiers à charger et quelques paramètres d’installation : il dicte donc à Odoo comment intégrer et exécuter le module.
Si le manifeste est mal formé, Odoo peut :
- ne pas détecter le module
- refuser son installation
- échouer lors d’une mise à jour
- générer une erreur serveur au démarrage
Les erreurs de manifeste sont particulièrement répandues lors du développement de modules sur mesure ou pendant des migrations entre versions.
Ce guide détaille les raisons courantes de ces erreurs et donne une méthode pas à pas pour les corriger proprement.
Qu’est-ce que le fichier manifeste dans Odoo ?
Chaque module Odoo possède obligatoirement un fichier __manifest__.py.
Exemple de contenu typique :
{
'name': 'Custom Sales Extension',
'version': '16.0.1.0.0',
'depends': ['base', 'sale'],
'data': [
'views/sale_order_view.xml',
'security/ir.model.access.csv',
],
'installable': True,
}
Ce fichier indique à Odoo plusieurs éléments essentiels :
- le nom du module
- les modules dont il dépend
- les fichiers à charger (vues, données, règles, etc.)
- s’il est installable
Si une information est erronée ici, le module risque de ne pas fonctionner correctement ni d’être exploitable en production.
Causes fréquentes d’erreurs liées au manifeste
1. Erreur de syntaxe Python
Le manifeste n’est rien d’autre qu’un dictionnaire Python. Toute coquille de syntaxe peut empêcher son chargement :
- une virgule oubliée
- une mauvaise indentation
- un crochet non fermé
- des guillemets incohérents
dans ces cas Odoo ne pourra pas lire le fichier et bloquera l’installation.
Exemple d’erreur fréquente :
'depends': ['base', 'sale'] 'data': ['views/view.xml']
Il manque une virgule après la clé depends.
2. Déclaration de dépendance incorrecte
Si la liste de dépendances référence un module inexistant ou mal orthographié, l’installation échouera :
'depends': ['sales']
au lieu de :
'depends': ['sale']
Odoo renverra une erreur liée à la dépendance introuvable.
3. Chemin de fichier invalide dans la section data
Si un fichier listé dans data n’existe pas dans l’arborescence du module :
'data': ['views/missing_view.xml']
l’installation s’interrompt avec une erreur signalant le fichier manquant.
4. Clés obsolètes ou non reconnues
L’usage de clés non supportées par la version d’Odoo en cours peut provoquer des comportements imprévus.
Les attributs attendus dans le manifeste varient selon les versions ; il faut adapter le format au bon numéro de version.
5. installable positionné à False
Si le manifeste contient :
'installable': False
le module n’apparaîtra pas dans la liste des Apps et ne pourra pas être installé.
Les développeurs oublient parfois de passer ce paramètre à True après le développement.
6. Format de version incorrect
Un format de version incohérent peut gêner les processus d’upgrade automatisés, notamment dans des pipelines de déploiement structurés.
Comment corriger une erreur de manifeste Odoo
Étape 1 – Consulter les logs du serveur
Au démarrage d’Odoo ou lors d’une mise à jour de la liste des applications, examinez les logs à la recherche d’un SyntaxError ou d’un traceback lié au manifeste.
SyntaxError
ou tracebacks mentionnant __manifest__.py.
La trace indique généralement la ligne problématique dans le fichier manifeste.
Étape 2 – Valider la syntaxe Python
Ouvrez le __manifest__.py et vérifiez :
- les virgules entre chaque entrée du dictionnaire
- une indentation cohérente
- les crochets et accolades correctement fermés
- des guillemets appariés
Même une petite erreur de formatage peut bloquer l’installation d’un module.
Étape 3 – Vérifier les dépendances
Contrôlez que tous les modules listés dans 'depends' existent réellement et que leurs noms sont exactement orthographiés.
'depends': []
Toute différence d’orthographe empêche la résolution des dépendances.
Étape 4 – Confirmer les chemins des fichiers data
Vérifiez que chaque entrée de la liste 'data' correspond à un fichier présent dans le répertoire du module.
'data': []
Corrigez toute faute de frappe ou emplacement incorrect.
Les fichiers mal placés ou mal nommés sont une cause fréquente d’échec à l’installation.
Étape 5 – Redémarrer et rafraîchir la liste des apps
Après avoir corrigé le manifeste :
- redémarrez le service Odoo
- ouvrez le menu Apps
- cliquez sur « Mettre à jour la liste des applications »
- puis retentez l’installation du module
Comment éviter les erreurs de manifeste
- Adopter une mise en forme cohérente pour __manifest__.py
- Valider la syntaxe avant tout déploiement
- Limiter et clarifier les dépendances
- Ne pas réutiliser un manifeste provenant d’une autre version d’Odoo sans l’adapter
- Utiliser le contrôle de version pour tracer les modifications
Des manifestes bien structurés évitent la plupart des soucis d’installation des modules.
Comment Dasolo garantit des modules correctement configurés
Les erreurs de manifeste paraissent souvent bénignes, mais elles peuvent empêcher totalement l’installation ou la mise à jour d’un module. Elles résultent généralement d’un problème de syntaxe, d’une dépendance mal déclarée ou d’un mauvais chemin de fichier.
Chez Dasolo, nous réduisons les pannes liées aux manifestes en mettant en place :
- une validation stricte de la syntaxe
- des dépendances définies de manière minimale et explicite
- un contrôle précis des chemins des fichiers data et des règles de sécurité
- une gestion de configuration consciente des versions d’Odoo
- des tests de déploiement en environnement de préproduction
Un flux de travail discipliné sur la configuration diminue les interruptions lors des déploiements et assure un comportement stable des modules entre les environnements.
Conclusion
L’« erreur de manifeste » signale un fichier de configuration corrompu ou mal défini : syntaxe invalide, dépendances introuvables ou références de fichiers incorrectes. Derrière ce message se cache souvent un manque de gouvernance sur la configuration des modules.
En inspectant rigoureusement la structure du manifeste, en validant les dépendances et en testant les modules avant mise en production, on évite la répétition de ces échecs d’installation. Une gestion propre et maîtrisée des fichiers __manifest__.py est indispensable pour des déploiements Odoo fiables et évolutifs.