Inhaltsverzeichnis

  1. Einführung

  2. Warum nach einem Update Fehler auftreten

  3. Best Practices zur Vermeidung von Updatefehlern

  4. Fehler 500: Interner Serverfehler

  5. Leerer Bildschirm nach der Anmeldung

  6. Modul wird nicht angezeigt oder fehlt

  7. Fehlerhafte PDF-Generierung

  8. Sprach- oder Übersetzungsprobleme

  9. Verzerrung des Designs/Layouts oder fehlende Symbole

  10. Berechtigungsprobleme nach dem Upgrade

  11. Datenbankmigrationskonflikte

  12. Conf.php-Fehlkonfigurationen

  13. Apache/Nginx-Umschreib- und Zugriffsfehler

  14. Veraltete Funktionen in benutzerdefinierten Modulen

  15. Inkompatibilität externer Module

  16. Fehlerprotokolle: Wo sie zu finden sind und wie sie zu lesen sind

  17. Schritt-für-Schritt-Debugging-Strategie

  18. Rollback auf eine frühere funktionierende Version

  19. Fehler an die Dolibarr-Community melden

  20. Fazit

1. Einleitung

Die Aktualisierung von Dolibarr kann bei guter Planung reibungslos verlaufen. In vielen Fällen stören jedoch Probleme nach der Aktualisierung die Arbeitsabläufe. Ob leere Bildschirme, Zugriffsfehler oder beschädigte PDFs – dieser Leitfaden hilft Ihnen, häufige Probleme zu lösen und Ihre ERP/CRM-Instanz zu stabilisieren.

2. Warum nach einem Update Fehler auftreten

Typische Ursachen sind:

  • Unvollständiger Dateiersatz

  • Alte Module/Themen sind mit der neuen Struktur nicht kompatibel

  • Datenbank-Upgrade-Skripte werden nicht vollständig ausgeführt

  • Falsch konfigurierte Serverumgebung (PHP-Version, Erweiterungen)

  • Zwischengespeicherte Einstellungen verursachen UI-Probleme

Wenn Sie die Grundursache verstehen, können Sie Probleme schneller lösen.

3. Best Practices zur Vermeidung von Update-Fehlern

Vor dem Update:

  • Alles sichern (Datenbank und Dateisystem)

  • Aktualisieren Sie zuerst auf einem Staging-Server

  • Deaktivieren Sie nicht unbedingt erforderliche Module

  • Suchen Sie auf GitHub oder in Foren nach bekannten Problemen

  • Lesen Sie das Änderungsprotokoll und die Versionshinweise

Führen Sie niemals ohne Tests ein direktes Update auf einer Produktionsinstanz durch.

4. Fehler 500: Interner Serverfehler

Dies ist ein allgemeiner Fehler. Mögliche Ursachen:

  • Falsche Dateiberechtigungen (chmod)

  • Syntaxfehler in angepassten PHP-Dateien

  • Inkompatible Module von Drittanbietern

Fix:

  • Überprüfen Sie die Fehlerprotokolle des Webservers (/var/log/apache2/error.log)

  • Legen Sie die Dateiberechtigungen fest auf 644 und Ordner zu 755

  • Deaktivieren Sie vorübergehend alle benutzerdefinierten Module und versuchen Sie es erneut

5. Leerer Bildschirm nach der Anmeldung

Häufige Ursachen:

  • PHP-Fehler unterdrückt (display_errors = Off)

  • Beschädigte Sitzungsdateien oder Cache

Fix:

  • Aktivieren Sie die Fehlerberichterstattung in conf.php

ini_set('display_errors', 1);
error_reporting(E_ALL);

  • Browser-Cache und Dolibarrs Cache-Ordner leeren /documents/temp

6. Modul wird nicht angezeigt oder fehlt

Symptome:

  • Ein zuvor aktives Modul ist nun verschwunden

Fix:

  • Gehe zu Setup > Module und aktivieren Sie es erneut

  • Wenn benutzerdefiniert, überprüfen Sie, ob es sich in befindet /custom/module/

  • Überprüfen Sie die Kompatibilität mit der aktuellen Dolibarr-Version

7. Fehlerhafte PDF-Generierung

Symptome:

  • PDF-Ausgaben sind leer oder fehlerhaft

Fix:

  • Suchen Sie nach fehlenden TCPDF-Bibliotheken

  • Gewährleisten /documents/ verfügt über die entsprechenden Schreibberechtigungen

  • Sprachdateien bestätigen (langs/) sind nicht beschädigt

Überprüfen Sie auch die benutzerdefinierte Vorlagenlogik auf veraltete TCPDF-Funktionen.

8. Sprach- oder Übersetzungsprobleme

Symptome:

  • Benutzeroberfläche nicht übersetzt oder es wird Kauderwelsch angezeigt

Fix:

  • Überprüfen Sie, ob Probleme mit der UTF-8-Kodierung vorliegen

  • Sprachdateien in der richtigen Kodierung erneut speichern

  • Überprüfen Sie, ob der Übersetzungsordner vorhanden ist unter /htdocs/langs/

  • Nutzen Sie Setup > Übersetzung > Wörterbuch neu erstellen

9. Design-/Layoutverzerrung oder fehlende Symbole

Symptome:

  • Das Layout scheint nach dem Update defekt zu sein

  • Symbole fehlen

Fix:

  • Löschen Sie den Browser-Cache

  • Kehren Sie zu einem unterstützten Design wie Oblyon zurück

  • Überprüfen Sie die Ladepfade für CSS/JS-Dateien in den Browser-Entwicklungstools

  • Stellen Sie sicher, dass keine benutzerdefinierten CSS-Dateien verloren gegangen oder beschädigt wurden

10. Berechtigungsprobleme nach dem Upgrade

Symptome:

  • Benutzern wird bei Modulen, auf die sie zuvor zugegriffen haben, die Meldung „Zugriff verweigert“ angezeigt.

Fix:

  • Benutzerberechtigungen zurücksetzen in Benutzer und Gruppen > Berechtigungen

  • Überprüfen der Benutzergruppenvererbung

  • Vergleichen Sie die alte und neue Modulberechtigungsstruktur

11. Datenbankmigrationskonflikte

Symptome:

  • Fehler beim Laden von Seiten mit Verweisen auf fehlende Tabellen oder Spalten

Fix:

  • Führen Sie den Update-Assistenten erneut aus unter /install/

  • Vergleichen Sie Schemata mit Tools wie phpMyAdmin

  • Fehlende Änderungen manuell anwenden von install/mysql/upgrade Skripte

12. Conf.php-Fehlkonfigurationen

Symptome:

  • Dolibarr wird überhaupt nicht geladen

Fix:

  • Einblick in das $dolibarr_main_url_root, $dolibarr_main_document_root und DB-Anschlussstrecken

  • Stellen Sie sicher, dass die Anführungszeichen korrekt sind und keine Leerzeichen am Ende stehen.

13. Apache/Nginx-Umschreib- und Zugriffsfehler

Symptome:

  • Fehler 404 oder 403 beim Zugriff auf Module

Fix:

  • Gewährleisten .htaccess ist intakt (Apache)

  • Bestätigen Sie, dass mod_rewrite aktiviert ist

  • Aktualisieren Sie für Nginx die Umschreiberegeln entsprechend

14. Veraltete Funktionen in benutzerdefinierten Modulen

Symptome:

  • Protokolle zeigen Warnungen oder Abstürze aufgrund veralteten Codes

Fix:

  • Vergleichen Sie den Code Ihres Moduls mit der aktualisierten Kernlogik

  • Ersetzen veralteter Funktionsaufrufe

  • Lesen Sie die Migrationshinweise in den GitHub-Releases von Dolibarr

15. Inkompatibilität externer Module

Symptome:

  • Module von Dolistore funktionieren nicht mehr

Fix:

  • Überprüfen Sie die Website des Anbieters auf eine aktualisierte Version

  • Wenden Sie sich für Unterstützung an den Autor des Moduls

  • Deaktivieren Sie das Modul vorübergehend

16. Fehlerprotokolle: Wo sie zu finden sind und wie sie zu lesen sind

  • Apache: /var/log/apache2/error.log

  • Nginx: /var/log/nginx/error.log

  • PHP: /var/log/php_errors.log

  • Dolibarr: /documents/admin/system.log (falls aktiviert)

Lesen Sie immer von unten nach oben, um die neuesten Ereignisse zu erfahren.

17. Schritt-für-Schritt-Debugging-Strategie

  1. Aktivieren Sie die Fehlerberichterstattung in conf.php

  2. Isolieren Sie das Problem (welches Modul, welcher Benutzer, welche Datei?)

  3. Überprüfen Sie die Webserver- und Dolibarr-Protokolle

  4. Nicht-Kernmodule deaktivieren

  5. Bei Bedarf auf eine Sicherung zurückgreifen

Keine Panik – die meisten Probleme lassen sich mit methodischen Schritten lösen.

18. Zurücksetzen auf eine frühere funktionierende Version

Wenn alles fehlschlägt:

  • Stellen Sie Ihre letzte Sicherung der Datenbank und der Dateien wieder her

  • Downgrade nur, wenn unbedingt nötig

  • Dokumentieren Sie die Ursache für das fehlgeschlagene Upgrade

Verwenden Sie Rollback nur, wenn Sie nicht weiterkommen, und planen Sie nach dem Debuggen einen erneuten Versuch ein.

19. Fehler an die Dolibarr-Community melden

Wenn Sie einen echten Fehler finden:

  • Suche das Dolibarr GitHub-Probleme

  • Senden Sie ein neues Problem mit:

    • Ihre Version

    • Schritte zum Reproduzieren

    • Protokolle oder Screenshots

Eine klare Berichterstattung erhöht Ihre Chancen, schnell Hilfe zu bekommen.

20. Fazit

Fehler nach Updates sind häufig, aber beherrschbar. Mit übersichtlicher Protokollierung, Backups und systematischem Debugging lassen sich die meisten Probleme schnell beheben. Nutzen Sie Staging-Umgebungen, halten Sie Drittanbietermodule aktuell und tragen Sie Fehlerbehebungen bei, um die Community zu stärken.