Introducción
Un Error de Dependencia de Módulo en Odoo surge cuando Odoo no puede instalar o actualizar un módulo porque faltan módulos requeridos, no están instalados o su declaración es incorrecta.
Normalmente este fallo se manifiesta en los siguientes momentos:
- Instalación de un módulo
- Actualización de un módulo
- Migración de base de datos
- Despliegue de módulos personalizados
Si las dependencias no están bien configuradas, Odoo detiene el proceso para evitar que el sistema quede en un estado inconsistente.
Esta guía muestra por qué aparecen estos errores y qué pasos seguir para resolverlos de forma correcta y duradera.
¿Qué significa una dependencia de módulo en Odoo?
Cada módulo de Odoo incluye un fichero __manifest__.py con una sección depends en la que se declaran las dependencias:
{
'name': 'Mi Módulo Personalizado',
'depends': ['base', 'sale'],
}
Esto indica lo siguiente:
- El módulo necesita que base y sale estén instalados
- Odoo instalará esas dependencias automáticamente si aún no existen
- El módulo utiliza modelos y funcionalidades provistas por esos paquetes
Si alguna dependencia falta o está mal indicada, Odoo lanzará un error de dependencias.
Causas más habituales de errores por dependencias en Odoo
1. Módulo requerido ausente
Si tu módulo depende de otro que no está instalado, Odoo no puede continuar con la instalación.
Ejemplo práctico:
'depends': ['stock']
Si stock no está instalado → la instalación falla.
2. Nombre de módulo incorrecto en el manifiesto
Un nombre mal escrito o equivocado impide que Odoo localice la dependencia.
'depends': ['sales']
Cuando en realidad debería ser:
'depends': ['sale']
Odoo no encontrará el paquete y se producirá un error.
3. Dependencias circulares
Situación típica:
- El módulo A depende de B
- y B depende de A
Odoo no puede calcular el orden de instalación correcto.
Las dependencias circulares provocan fallos en la instalación.
4. Módulo personalizado fuera del addons_path
Si la dependencia es un módulo personalizado y no está en los directorios configurados (addons_path), Odoo no lo detectará.
5. Módulo instalado pero no cargado correctamente
Si una dependencia quedó con una instalación incompleta o fallida en el pasado, el sistema puede considerarla no disponible.
6. Incompatibilidad de versiones entre módulos
Un módulo hecho para otra versión de Odoo puede entrar en conflicto durante la instalación o la actualización.
Cómo solucionar un error de dependencia de módulo en Odoo
Paso 1 – Revisa el mensaje de error
El mensaje suele indicar exactamente qué dependencia falta o cuál es el problema.
Ejemplo práctico:
Ejemplo: ModuleNotFoundError: No module named 'stock'
O bien:
Unmet dependencies: sale_management
Paso 2 – Verifica el fichero manifest
Abre __manifest__.py y comprueba:
- Que los nombres de los módulos sean correctos
- Ortografía exacta
- Ausencia de comas finales o errores de sintaxis
Compara los nombres con las referencias técnicas oficiales de Odoo.
Paso 3 – Instala las dependencias faltantes
Procedimiento recomendado:
Apps → busca el módulo que falta → Instalar
Si es un módulo personalizado, asegúrate de que:
- Está presente en la carpeta de addons
- Está incluido en addons_path
- Aparece en el listado de Apps dentro de Odoo
De lo contrario, Odoo no podrá usarlo como dependencia.
Paso 4 – Reinicia el servidor de Odoo
- Tras corregir las dependencias:
- Reinicia el servicio de Odoo
- Actualiza la lista de aplicaciones
Vuelve a intentar la instalación del módulo
Paso 5 – Elimina dependencias circulares
- Si detectas una dependencia circular, las soluciones comunes son:
- Extraer la lógica común a un tercer módulo independiente
Eliminar dependencias cruzadas innecesarias
Mantener una jerarquía clara entre módulos para evitar retornos
Paso 6 – Comprueba la configuración de addons_path
Revisa el archivo de configuración de Odoo:
addons_path = /ruta/a/odoo/addons,/ruta/a/addons/personalizados
Cómo evitar errores de dependencias de módulos
- Asegúrate de que todos los módulos necesarios estén en esas carpetas y accesibles para Odoo.
- Buenas prácticas recomendadas: declara siempre las dependencias explícitamente
- Mantén una estructura de módulos limpia y modular
- Evita las dependencias circulares
- Usa los nombres técnicos correctos de los módulos
- Prueba las instalaciones en un entorno de staging antes de producción
Documenta las relaciones entre los módulos personalizados
Cómo organiza Dasolo las dependencias de sus módulos
Un diseño de módulos ordenado evita la mayoría de los fallos por dependencias cuando el proyecto crece.
Los errores de dependencia suelen revelar arquitecturas de módulos confusas o dependencias ocultas entre componentes personalizados. En entornos Odoo en expansión, la falta de control sobre estas relaciones acaba provocando errores en instalaciones y actualizaciones.
- En Dasolo prevenimos conflictos siguiendo principios claros:
- Declaraciones de dependencias explícitas
- Límites bien definidos entre módulos
- Acoplamiento mínimo entre módulos
- Evitar referencias circulares
Documentación estructurada de componentes personalizados
Conclusión
Una arquitectura de dependencias limpia facilita instalaciones predecibles y reduce el coste de mantenimiento a largo plazo en proyectos Odoo.
El “Error de Dependencia de Módulo” en Odoo aparece cuando faltan, están mal declarados o entran en conflicto los módulos requeridos durante la instalación o actualización. Aunque el sistema muestra el fallo, la causa raíz suele ser una estructura de módulos pobre o desorganizada.