Inhaltsverzeichnis

  1. Einführung

  2. Warum es wichtig ist, Fehler in Dolibarr zu verstehen

  3. Fehlerkategorien in Dolibarr

  4. Fehler Nr. 1: „Zugriff verboten“ oder „Sie haben keine Berechtigung“

  5. Fehler Nr. 2: „Modul nicht gefunden“ nach Upgrade oder Installation

  6. Fehler Nr. 3: Weißer Bildschirm oder leere Seite

  7. Fehler Nr. 4: PDF-Generierung schlägt fehl (TCPDF- oder DOMPDF-Fehler)

  8. Fehler Nr. 5: SQL- oder Datenbankverbindungsfehler

  9. Fehler Nr. 6: Cron-Jobs werden nicht ausgeführt

  10. Fehler Nr. 7: Zeitzone oder Datum stimmen nicht überein

  11. Fehler Nr. 8: Sitzungs-Timeout oder automatische Abmeldung

  12. Fehler Nr. 9: Datei-Upload oder -Download schlägt fehl

  13. Fehler Nr. 10: API-Authentifizierungs- oder Token-Fehler

  14. Debugging-Tools und Best Practices

  15. Abschließende Gedanken

1. Einleitung

Dolibarr ERP & CRM ist eine leistungsstarke und modulare Open-Source-Plattform für die Verwaltung sämtlicher Bereiche – von Rechnungsstellung und Buchhaltung bis hin zu Personalwesen, Inventar und Kundenbeziehungen. Dank seiner Einfachheit, Erweiterbarkeit und Kosteneffizienz ist es bei KMU und Freiberuflern weltweit beliebt.

Wie jedes komplexe webbasierte System ist Dolibarr jedoch nicht immun gegen gelegentliche Fehler, Bugs und Fehlkonfigurationen. Egal, ob Sie Systemadministrator, Entwickler oder Geschäftsbenutzer sind, das Auftreten eines Fehlers kann Ihren Arbeitsablauf stören und Ihr Vertrauen in die Plattform verringern.

Dieser Artikel untersucht die häufigste Dolibarr-Fehler, ihre zugrunde liegenden Ursachen und praktische, schnelle Lösungen. Ziel ist es nicht nur, Probleme zu beheben, sondern den Benutzern ein besseres Verständnis zu vermitteln wie Dolibarr hinter den Kulissen arbeitet.

2. Warum es wichtig ist, Fehler in Dolibarr zu verstehen

Fehler passieren – ob bei der Installation, bei Upgrades, der Konfiguration oder im täglichen Gebrauch. Einige Fehler werden verursacht durch:

  • Fehlkonfiguration des Servers

  • Probleme mit den Dateiberechtigungen

  • Inkompatible Module oder Vorlagen

  • PHP- oder MySQL-Version stimmt nicht überein

  • Missmanagement der Benutzerzugriffsrechte

  • Cron- oder Cache-Probleme

Der Schlüssel zur effizienten Fehlerbehebung liegt in der Erkennung der Fehlermusterwissend wo zu suchenund die Anwendung der schnell die richtige Lösung. Das Lernen aus diesen Fehlern hilft auch dabei, zukünftige Vorkommnisse zu verhindern, die Systemverfügbarkeit zu erhöhen und das Vertrauen der Benutzer zu stärken.

3. Fehlerkategorien in Dolibarr

Dolibarr-Fehler fallen im Allgemeinen in die folgenden Kategorien:

  • Authentifizierung und Berechtigungen: Zugriffsverweigerung, Anmeldeprobleme

  • Probleme mit Modulen und Plugins: Fehlende Dateien, inkompatible Versionen

  • Benutzeroberfläche und Rendering: Weiße Bildschirme, defekte Layouts

  • Backend/Server: PHP-Fehler, Speichergrenzen, Datenbankprobleme

  • Cron & Automatisierung: Fehlgeschlagene Hintergrundaufgaben

  • Externe Werkzeuge: PDF-Generierung, Datei-Uploads/Downloads

  • API & Integration: Authentifizierungs- und Verbindungsfehler

Lassen Sie uns nun die häufigsten Einzelfehler und deren effiziente Lösung untersuchen.

4. Fehler Nr. 1: „Zugriff verboten“ oder „Sie haben keine Berechtigung“

Symptome:

  • Meldung: „Zugriff verboten“ oder „Sie haben keine Berechtigung, auf diese Seite zuzugreifen.“

  • Betrifft normale Benutzer, die versuchen, auf Module zuzugreifen, auf die sie Zugriff haben sollten.

Ursachen:

  • Der Rolle des Benutzers sind nicht die richtigen Rechte zugewiesen.

  • Das Modul ist deaktiviert oder nicht richtig initialisiert.

  • Konflikt mit benutzerdefinierten Berechtigungen oder Modulen von Drittanbietern.

Solutions:

  1. Gehe zu Home > Benutzer und Gruppen > Benutzer > [Benutzer auswählen]

  2. Überprüfen Sie, ob Ihre Gruppe über die erforderlichen Rechte verfügt. Berechtigungen.

  3. Überprüfen Sie, ob das Modul aktiviert ist in Setup > Module/Anwendungen.

  4. Initialisieren Sie die Modulberechtigungen erneut, wenn benutzerdefinierte Änderungen vorgenommen wurden.

Kurztipp: Verwenden Sie die Admin-Benutzer um den Zugriff zu überprüfen und sicherzustellen, dass keine globale Einschränkung aktiviert ist.

5. Fehler Nr. 2: „Modul nicht gefunden“ nach Upgrade oder Installation

Symptome:

  • Fehlermeldung beim Aufruf einer Modulseite

  • Fehlende Einträge in der Modulliste

  • Menüs verschwinden nach der Aktivierung eines Moduls

Ursachen:

  • Unsachgemäße Modulordnerstruktur

  • Die Modulversion ist nicht mit der aktuellen Dolibarr-Version kompatibel

  • Fehlende oder falsche Moduldeskriptordateien (modXXX.class.php)

Solutions:

  1. Überprüfen Sie, ob das Modul im richtigen Verzeichnis abgelegt ist:
    /htdocs/custom/[module_name]/

  2. Bestätigen Sie, dass die Hauptklassendatei des Moduls richtig benannt ist.

  3. Leeren Sie den Dolibarr-Cache über Admin > Tools > Cache leeren.

  4. Wenn Dolibarr kürzlich aktualisiert wurde, aktualisieren Sie das Modul auf eine kompatible Version.

6. Fehler Nr. 3: Weißer Bildschirm oder leere Seite

Symptome:

  • Ein völlig leerer Bildschirm ohne Fehler

  • Passiert nach dem Login oder beim Öffnen bestimmter Module

Ursachen:

  • PHP-Schwerwiegender Fehler (wird aufgrund der Servereinstellungen oft nicht angezeigt)

  • Gedächtniserschöpfung

  • Unvollständiges Upgrade

  • Probleme mit den Dateiberechtigungen

Solutions:

  1. Überprüfen Sie Ihre PHP-Fehlerprotokolle (z. B. /var/log/php/error.log).

  2. Aktivieren Sie die Fehleranzeige durch Hinzufügen zu htdocs/main.inc.php:

    php

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

  3. Erhöhen Sie das Speicherlimit in php.ini:

    ini

    memory_limit = 512M

  4. Laden Sie fehlende oder beschädigte Dateien erneut hoch oder ersetzen Sie sie.

7. Fehler Nr. 4: PDF-Generierung schlägt fehl (TCPDF- oder DOMPDF-Fehler)

Symptome:

  • Rechnungen oder Angebote können nicht als PDF generiert werden

  • Leere PDFs oder fehlerhafte Formatierung

  • Meldungen wie „TCPDF-FEHLER: Einige Daten wurden bereits ausgegeben“ oder DOMPDF-Ausnahmen

Ursachen:

  • Beschädigte PDF-Vorlagen

  • Vor den Headern gesendete Ausgabe

  • Fehlende Schriftarten oder falsche Berechtigungen in /documents/ Verzeichnis

  • DOMPDF-Fehlkonfiguration

Solutions:

  1. Wechseln Sie zu einem anderen PDF-Modell in Setup > Wörterbücher > Vorlagen

  2. Überprüfen Sie, ob in den PHP-Vorlagendateien versehentlich Leerzeichen vorhanden sind (insbesondere vor <?php oder danach ?>)

  3. Legen Sie die richtigen Berechtigungen fest für /documents/:

    bash

    chmod -R 755 /dolibarr/documents/

  4. Wenn Sie DOMPDF verwenden, stellen Sie sicher, dass die erforderlichen Schriftarten und PHP-Erweiterungen installiert sind.

8. Fehler Nr. 5: SQL- oder Datenbankverbindungsfehler

Symptome:

  • Meldungen „Datenbankverbindung fehlgeschlagen“ oder „SQL-Fehler“

  • Nach der Migration oder Konfigurationsänderungen treten Fehler auf

Ursachen:

  • Falsche DB-Anmeldeinformationen in conf.php

  • MySQL/MariaDB-Dienst ausgefallen

  • Server-Ressourcenbeschränkungen (z. B. maximale Verbindungen)

Solutions:

  1. Datenbankstatus prüfen:

    bash

    systemctl status mysql

  2. Öffne htdocs/conf/conf.php und bestätigen Sie DB-Name, Benutzer und Passwort.

  3. Testen Sie die DB-Anmeldeinformationen manuell über die CLI:

    bash

    mysql -u dolibarr_user -p

  4. Überprüfen Sie die Protokolle auf fehlgeschlagene Abfragen oder Berechtigungsfehler.

9. Fehler Nr. 6: Cron-Jobs werden nicht ausgeführt

Symptome:

  • Geplante Aufgaben nicht ausgeführt

  • E-Mail-Erinnerungen, wiederkehrende Rechnungen und Backups lösen nicht aus

Ursachen:

  • Cron-Job falsch konfiguriert

  • cron.php aufgrund von Webserver-Regeln nicht erreichbar

  • Skript-Timeouts oder Berechtigungsfehler

Solutions:

  1. Bestätigen Sie die Cron-Einrichtung mit:

    bash

    crontab -l

    Beispiel für einen Cron-Job:

    bash

    */10 * * * * wget -qO- https://yourdomain.com/public/cron/cron.php

  2. Stellen Sie sicher, dass die richtigen Berechtigungen für cron.php (755 oder 644).

  3. Cron-Protokolle überprüfen: /var/log/syslog or /var/log/cron.log

  4. Nutzen Sie cronjob.class.php Protokolle zum Debuggen der Aufgabenausführung.

10. Fehler Nr. 7: Zeitzone oder Datum stimmen nicht überein

Symptome:

  • Falsche Datumsangaben in Rechnungen, Protokollen oder Kalendereinträgen

  • Diskrepanzen zwischen Benutzereingaben und Systemspeicher

  • Unerwartetes Verhalten beim Exportieren von Daten in externe Systeme

Ursachen:

  • Nichtübereinstimmung zwischen PHP-Zeitzone und Dolibarr-Konfiguration

  • Der Server verwendet UTC, während die Benutzer die lokale Zeit erwarten

  • MySQL-Zeitzone stimmt nicht mit PHP überein

Solutions:

  1. In der PHP-Konfiguration (php.ini), stellen Sie die richtige Zeitzone ein:

    ini
    date.timezone = "Africa/Casablanca"

  2. Bestätigen Sie in Dolibarr die Zeitzone unter:

    Home > Setup > Sonstiges > Regionale Einstellungen

  3. MySQL-Zeitzone synchronisieren:

    SQL
    SET GLOBAL time_zone = 'Africa/Casablanca';

  4. Starten Sie Web- und Datenbankserver neu, um die Einstellungen konsistent anzuwenden.

11. Fehler Nr. 8: Sitzungs-Timeout oder automatische Abmeldung

Symptome:

  • Benutzer werden nach kurzer Zeit unerwartet abgemeldet

  • Sitzungen bleiben zwischen Tab-Wechseln nicht bestehen

  • Die Meldung „Sie müssen sich erneut anmelden“ wird häufig angezeigt.

Ursachen:

  • Kurzes Sitzungs-Timeout in PHP

  • Konflikte bei der Sitzungsspeicherung (insbesondere bei mehreren Benutzern)

  • Cache- oder Cookie-Probleme im Browser

  • Mehrere Dolibarr-Instanzen stehen in Konflikt mit derselben Domäne

Solutions:

  1. In php.ini, Satz:

    ini
    session.gc_maxlifetime = 3600

  2. Aktivieren Sie dauerhafte Sitzungen mit den richtigen Pfadeinstellungen.

  3. Vermeiden Sie die Verwendung mehrerer Dolibarr-Installationen unter derselben Domäne ohne klare Cookie-Trennung.

  4. Verwenden Sie das Erzwinge HTTPS und aktivieren Sie SameSite=None Header bei Verwendung sicherer Cookies über Subdomänen hinweg.

12. Fehler Nr. 9: Datei-Upload oder -Download schlägt fehl

Symptome:

  • Dokumente, Bilder oder Logos von Lieferanten können nicht hochgeladen werden

  • Downloads führen zu leeren oder beschädigten Dateien

  • Fehler: „Datei nicht gefunden“ oder „Keine Datei hochgeladen“

Ursachen:

  • Falsche Dateiberechtigungen in /documents/ Flyer

  • PHP upload_max_filesize zu klein

  • Temporärer Ordner nicht beschreibbar

  • MIME-Typ-Einschränkungen oder Server-Dateilimits

Solutions:

  1. Legen Sie die richtigen Berechtigungen fest für documents Verzeichnis:

    bash
    chown -R www-data:www-data /dolibarr/documents chmod -R 755 /dolibarr/documents

  2. In php.ini, Grenzwerte erhöhen:

    ini
    upload_max_filesize = 20M post_max_size = 25M

  3. Bestätigen Sie, dass Dateitypen im Dolibarr-Setup zulässig sind (unter Modulkonfiguration).

  4. Testen Sie Uploads zunächst mit kleinen Dateien, um andere Probleme auszuschließen.

13. Fehler Nr. 10: API-Authentifizierungs- oder Token-Fehler

Symptome:

  • REST-API-Aufrufe geben „Nicht autorisiert“ oder „Ungültiges Token“ zurück.

  • Externe Integrationen können keine Verbindung herstellen

  • Probleme beim Ablauf des Tokens nach kurzer Zeit

Ursachen:

  • Falsche API-Anmeldeinformationen

  • Tokenbasierte Authentifizierung nicht korrekt implementiert

  • API deaktiviert oder Benutzerberechtigungen zu eingeschränkt

  • Falsch ausgerichtete URL- oder Endpunktpfade

Solutions:

  1. Bestätigen Sie, dass die API aktiviert ist unter:

    Home > Setup > Module > Webservices (API)

  2. Erstellen Sie einen technischen Benutzer mit entsprechenden API-Rechten.

  3. Stellen Sie sicher, dass das Token in der DOLAPIKEY Header oder Abfrageparameter.

  4. Verwenden Sie das richtige Endpunktformat:

    Rubin
    https://yourdomain.com/api/index.php/<resource>?DOLAPIKEY=xxx

  5. Aktivieren Sie API-Debug-Protokolle in conf.php durch Einstellung:

    php
    $dolibarr_main_prod = 0;

  6. Überprüfen Sie, ob der Benutzer Zugriff auf das Modul hat, das Sie abfragen möchten (z. B. Rechnungen, Produkte).

14. Debugging-Tools und Best Practices

Um Fehler schnell zu beheben und zukünftige Probleme zu reduzieren, implementieren Sie eine proaktive Debugging- und Überwachungsstrategie.

Aktivieren Sie den Entwicklermodus

Fügen Sie dies hinzu htdocs/conf/conf.php:

php
define('DOL_DEVELOPER_MODE', true);

Dadurch werden unten auf jeder Seite Ausführungszeiten, SQL-Abfragen und Speichernutzung angezeigt.

Fehlerprotokolle verwenden

  • PHP-Protokolle: /var/log/php/error.log or php-fpm.log

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

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

  • MySQL-Protokolle: /var/log/mysql/error.log

Überprüfen Sie diese regelmäßig, insbesondere nach:

  • Modulinstallationen

  • Dolibarr-Versions-Upgrades

  • Serverneukonfiguration

Verwenden Sie Git für Anpassungen

Wenn Sie Dateien oder benutzerdefinierte Module ändern:

  • Versionieren Sie sie mit Git

  • Verfolgen Sie Änderungen vor und nach Upgrades

  • Bei auftretenden Fehlern schnell zurückgreifen

Erstellen einer Staging-Umgebung

  • Testen Sie neue Module, Vorlagen oder Einstellungen immer auf einer Kopie Ihrer Dolibarr-Instanz

  • Verwenden Sie Staging, um Upgrades zu simulieren und veraltete Funktionen zu finden

  • Verwenden Sie Backups (sowohl Datenbank als auch /documents/) vor größeren Änderungen

15. Letzte Gedanken

Fehler sind Teil jedes Softwaresystems, insbesondere in einer so anpassbaren und modularen Umgebung wie DolibarrWas einen erfolgreichen Einsatz auszeichnet, ist nicht die Fehlerfreiheit, Aber die Fähigkeit, diese schnell und sicher zu lösen.

Hier ist eine kurze Zusammenfassung der Best Practices:

  • Verstehen Sie die Quelle: Hängt es mit dem Server, der App, den Benutzerrechten oder dem Modul zusammen?

  • Verwenden Sie Protokolle und Debug-Modi um aussagekräftige Informationen zu erhalten

  • Halten Sie das System schlank: Deaktivieren Sie nicht verwendete Module und halten Sie Ihre Installation sauber

  • Planen Sie Wachstum: Setzen Sie realistische Grenzen und bereiten Sie sich auf mehr Benutzer oder Datensätze vor

  • Keine Angst vor Fehlern – dokumentieren Sie sie und integrieren Sie sie in Ihre IT-Management-Strategie

Durch die Beherrschung dieser häufigen Fehler und deren Lösungen reduzieren Sie Ausfallzeiten, verbessern die Benutzerzufriedenheit und erhalten eine schnelle, sichere und zuverlässige Dolibarr-Umgebung.