Einleitung
Ein Odoo Manifest Error tritt auf, wenn die Datei __manifest__.py innerhalb eines Moduls fehlerhaft ist. Diese Datei ist entscheidend, weil sie die wichtigsten Metadaten des Moduls definiert: Name, Abhängigkeiten, einzubindende Dateien und grundlegende Konfigurationseinstellungen.
Wenn das Manifest fehlerhaft ist, kann Odoo folgendes tun:
- Das Modul nicht erkennen
- Die Installation verweigern
- Beim Upgrade fehlschlagen
- Beim Serverstart einen Fehler auslösen
Manifest-Fehler treten besonders häufig bei individuell entwickelten Modulen und während Versionsmigrationen auf.
Diese Anleitung erläutert die Ursachen für Manifest-Fehler und zeigt praxisnahe Lösungen.
Was ist die Manifest-Datei in Odoo?
Jedes Odoo-Modul enthält eine Datei namens __manifest__.py.
Beispiel:
{
'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,
}
Diese Datei informiert Odoo über folgende Punkte:
- Wie das Modul heißt
- Auf welche anderen Module es angewiesen ist
- Welche Dateien beim Laden berücksichtigt werden sollen
- Ob das Modul installierbar ist
Wenn hier etwas nicht stimmt, kann das Modul nicht korrekt funktionieren.
Typische Ursachen für Manifest-Fehler in Odoo
1. Python-Syntaxfehler
Das Manifest ist ein Python-Dictionary. Fehlerhafte Syntax führt dazu, dass Odoo die Datei nicht parsen kann.
- Fehlendes Komma
- Falsche Einrückung
- Nicht geschlossene Klammer
- Ungültige Anführungszeichen
In all diesen Fällen lädt Odoo das Modul nicht.
Beispiel für einen Fehler:
'depends': ['base', 'sale'] 'data': ['views/view.xml']
Es fehlt ein Komma nach dem depends-Eintrag.
2. Falsche Abhängigkeitsangaben
Wenn in 'depends' ein nicht vorhandenes Modul steht, kann Odoo die Abhängigkeit nicht auflösen.
'depends': ['sales']
Stattdessen sollte es heißen:
'depends': ['sale']
Odoo wirft dann einen Abhängigkeitsfehler.
3. Falscher Pfad in der Datenliste
Wenn unter 'data' auf nicht vorhandene Dateien verwiesen wird, scheitert die Installation.
'data': ['views/missing_view.xml']
Odoo bricht die Installation ab, weil die Datei fehlt.
4. Veraltete oder ungültige Schlüssel
Keys, die in der verwendeten Odoo-Version nicht unterstützt werden, führen zu Problemen.
Manifest-Attribute müssen zur Odoo-Version passen.
5. installable auf False gesetzt
Wenn:
'installable': False
erscheint das Modul nicht in der App-Liste.
Entwickler vergessen manchmal, den Wert auf True zu setzen.
6. Falsches Versionsformat
Ein ungültiges Versionstemplate kann insbesondere in automatisierten Deployment-Pipelines Probleme beim Upgrade verursachen.
So beheben Sie einen Manifest-Fehler in Odoo
Schritt 1 – Server-Logs prüfen
Beim Start von Odoo oder beim Aktualisieren der App-Liste sollten Sie die Log-Dateien kontrollieren auf:
SyntaxError
Oder Tracebacks, die auf das Manifest verweisen.
Meist zeigt die Fehlermeldung die genaue Zeile in __manifest__.py an.
Schritt 2 – Python-Syntax validieren
Öffnen Sie das Manifest und prüfen Sie:
- Dass zwischen Dictionary-Einträgen Kommata stehen
- Die Einrückung korrekt ist
- Klammern geschlossen sind
- String-Anführungen korrekt verwendet werden
Schon kleine Formatierungsfehler können die Installation blockieren.
Schritt 3 – Abhängigkeiten überprüfen
Stellen Sie sicher, dass alle Module in:
'depends': []
tatsächlich existieren und richtig geschrieben sind.
Schritt 4 – Daten-Dateipfade bestätigen
Prüfen Sie, dass jede Datei in:
'data': []
wirklich im Modulverzeichnis liegt.
Achten Sie auf Tippfehler und falsche Verzeichnisse.
Schritt 5 – Neustart und App-Liste aktualisieren
Nach den Korrekturen sollten Sie:
- Odoo neu starten
- Ins Apps-Menü wechseln
- „Update Apps List“ ausführen
- Und die Installation erneut versuchen
So vermeiden Sie Manifest-Fehler
- Halten Sie das __manifest__.py konsistent formatiert
- Validieren Sie die Syntax vor dem Deployment
- Halten Sie Abhängigkeiten schlank und eindeutig
- Kopieren Sie keine Manifeste aus anderen Odoo-Versionen ohne Anpassung
- Nutzen Sie Versionskontrolle, um Änderungen nachzuverfolgen
Sauber strukturierte Manifeste vermeiden die meisten Installationsprobleme.
Wie Dasolo saubere Modulkonfigurationen durchsetzt
Manifest-Fehler wirken oft harmlos, können aber die gesamte Modulinstallation oder ein Upgrade blockieren. Meist liegen die Ursachen in Syntaxfehlern, falschen Abhängigkeiten oder fehlerhaften Dateipfaden.
Bei Dasolo vermeiden wir Manifest-Ausfälle durch Maßnahmen wie:
- Strenge Syntaxprüfung
- Klare, minimale Abhängigkeitsdefinitionen
- Genaue Referenzen zu Daten- und Sicherheitsdateien
- Versionsbewusste Konfigurationsverwaltung
- Vorabtests in Staging-Umgebungen
Ein disziplinierter Konfigurations-Workflow reduziert Deploy-Unterbrechungen und sorgt für stabile Module in allen Umgebungen.
Fazit
Der Odoo-„Manifest Error“ entsteht, wenn die Modulkonfiguration Syntaxfehler, falsche Abhängigkeiten oder ungültige Dateireferenzen enthält. Häufig ist das ein Symptom mangelnder Konfigurationsdisziplin.
Durch sorgfältiges Prüfen der Manifest-Struktur, das Validieren von Abhängigkeiten und gründliche Tests vor dem Produktiveinsatz lassen sich wiederkehrende Installationsfehler vermeiden. Eine saubere Modulkonfiguration ist die Grundlage für zuverlässige und skalierbare Odoo-Installationen.