Introduction
Une erreur de dépendance de module Odoo se produit lorsque Odoo ne peut pas installer ou mettre à niveau un module parce qu'un ou plusieurs modules requis sont manquants, non installés ou déclarés incorrectement.
Ce type d'erreur apparaît généralement lors de :
- Installation de module
- Mise à niveau de module
- Migration de base de données
- Déploiement de module personnalisé
Lorsque les dépendances ne sont pas correctement configurées, Odoo bloque le processus pour éviter un comportement incohérent du système.
Ce guide explique pourquoi des erreurs de dépendance de module se produisent et comment les corriger correctement.
Qu'est-ce qu'une dépendance de module dans Odoo ?
Chaque module Odoo contient un fichier __manifest__.py avec une section depends :
{
'name': 'Mon Module Personnalisé',
'depends': ['base', 'sale'],
}
Cela signifie :
- Le module nécessite que base et sale soient installés
- Odoo les installera automatiquement si nécessaire
- Le module s'appuie sur leurs modèles et fonctionnalités
Si l'une de ces dépendances est manquante ou déclarée incorrectement, Odoo génère une erreur de dépendance.
Causes courantes des erreurs de dépendance de module Odoo
1. Module Requis Manquant
Si votre module dépend d'un autre module qui n'est pas installé, Odoo ne peut pas continuer.
Exemple :
'depends': ['stock']
Si le stock n'est pas installé → l'installation échoue.
2. Nom de module incorrect dans le manifeste
Si le nom de la dépendance est incorrect :
'depends': ['ventes']
Au lieu de :
'depends': ['vente']
Odoo ne trouvera pas le module et renverra une erreur.
3. Dépendances circulaires
Si :
- Le module A dépend du module B
- Le module B dépend du module A
Odoo ne peut pas résoudre l'ordre d'installation.
Les dépendances circulaires provoquent un échec de l'installation.
4. Module personnalisé non dans le chemin des addons
Si une dépendance est un module personnalisé mais n'est pas située dans le addons_path configuré, Odoo ne peut pas le détecter.
5. Module installé mais pas chargé correctement
Si le module de dépendance a été partiellement installé ou a échoué lors de l'installation précédente, le système peut le considérer comme indisponible.
6. Incompatibilité de version entre les modules
Si un module personnalisé a été construit pour une version différente d'Odoo, des conflits de dépendance peuvent survenir lors de l'installation ou de la mise à niveau.
Comment corriger l'erreur de dépendance de module Odoo
Étape 1 – Vérifiez le message d'erreur
Le message d'erreur spécifie généralement quelle dépendance est manquante.
Exemple :
ModuleNotFoundError: Aucun module nommé 'stock'
Ou :
Dépendances non satisfaites : sale_management
Étape 2 – Vérifier le fichier Manifest
Ouvrez __manifest__.py et vérifiez :
- Noms de module corrects
- Orthographe appropriée
- Pas de virgules finales ou d'erreurs de syntaxe
Comparez les noms avec les noms techniques des modules officiels dans Odoo.
Étape 3 – Installer les dépendances manquantes
Allez à :
Applications → Recherchez le module manquant → Installer
S'il s'agit d'un module personnalisé, assurez-vous qu'il est :
- Présent dans le dossier des addons
- Énuméré dans addons_path
- Visible dans le menu Applications
Étape 4 – Redémarrer le serveur Odoo
Après avoir corrigé les problèmes de dépendance :
- Redémarrer le serveur
- Mettre à jour la liste des applications
- Réessayer l'installation
Étape 5 – Éviter les dépendances circulaires
S'il existe une dépendance circulaire :
- Refactoriser la logique partagée dans un troisième module
- Supprimer les dépendances croisées inutiles
Les modules doivent avoir des relations hiérarchiques claires.
Étape 6 – Vérifier la configuration du chemin des addons
Vérifiez votre fichier de configuration Odoo :
addons_path = /chemin/vers/odoo/addons,/chemin/vers/addons/personnalisés
Assurez-vous que tous les modules requis se trouvent dans ces répertoires.
Comment prévenir les erreurs de dépendance de module
- Déclarez toujours les dépendances de manière explicite
- Gardez la structure des modules propre et modulaire
- Évitez les dépendances circulaires
- Utilisez les noms de modules techniques corrects
- Testez l'installation dans un environnement de staging
- Documentez les relations entre les modules personnalisés
Une architecture de module bien structurée prévient la plupart des échecs d'installation liés aux dépendances.
Comment Dasolo structure des dépendances de module propres
Les erreurs de dépendance des modules indiquent généralement des hiérarchies de modules peu claires ou des dépendances croisées cachées entre des composants personnalisés. À mesure que les environnements Odoo se développent, des dépendances non gérées peuvent rapidement entraîner des échecs d'installation ou de mise à niveau.
Chez Dasolo, nous prévenons les conflits de dépendance en nous concentrant sur :
- Des déclarations de dépendance explicites
- Des frontières de module claires
- Un couplage minimal entre les modules
- L'évitement des références circulaires
- Une documentation structurée des composants personnalisés
Une architecture de dépendance propre garantit des installations prévisibles et une maintenabilité à long terme à travers les projets Odoo.
Conclusion
L'erreur de dépendance de module Odoo se produit lorsque des modules requis sont manquants, mal déclarés ou en conflit lors de l'installation ou de la mise à niveau. Bien que le système signale clairement les dépendances non satisfaites, le problème plus profond réside souvent dans une mauvaise structuration des modules.
En examinant attentivement les fichiers manifestes, en maintenant des hiérarchies de modules propres et en validant les dépendances avant le déploiement, les développeurs peuvent prévenir les conflits d'installation récurrents. Une architecture de module disciplinée est essentielle pour des environnements Odoo stables et évolutifs.