Zum Hauptinhalt gehen

CSV-Import - Fehlerbehebung

Aktualisiert

In diesem Artikel besprechen wir folgende Punkte:

  • Häufige Fehlermeldungen bei einem CSV-Import
  • Konkrete Beispiele für Fehlermeldungen
  • Prüfpunkte, wenn ein Import nicht gelingt
  • Tipps & Tricks für einen erfolgreichen Import
  • Fehlerbehebung über die Browserkonsole

Häufige Fehlermeldungen bei einem CSV-Import

Beim Importieren einer CSV-Datei können verschiedene Fehlermeldungen auftreten. Nachfolgend findest du eine Übersicht häufiger Meldungen und möglicher Ursachen.

Datei kann nicht verarbeitet werden

Dies bedeutet häufig, dass die Struktur der CSV-Datei nicht korrekt ist.

Prüfe Folgendes:

  • Die Datei ist als .csv gespeichert
  • Die Spalten sind durch Kommas oder Semikolons getrennt
  • Die Spaltennamen in der ersten Zeile sind korrekt geschrieben
  • Es gibt keine leeren Spalten oder Zeilen in der Datei

Erforderliche Spalte fehlt

Manche Felder sind für einen erfolgreichen Import verpflichtend.

Prüfe, ob:

  • Alle erforderlichen Spalten in der Datei vorhanden sind
  • Die Spaltennamen exakt der erforderlichen Struktur entsprechen
  • Die erste Zeile nur Spaltennamen enthält

Falscher Wert oder falsches Format

Diese Meldung erscheint, wenn Werte nicht dem erwarteten Format entsprechen.

Prüfe zum Beispiel:

  • E-Mail-Adressen haben ein gültiges Format
  • Datumsangaben stehen im richtigen Datumsformat
  • Numerische Felder enthalten nur Zahlen

Konkrete Beispiele für Fehlermeldungen

Nachfolgend Beispiele für Fehlermeldungen, die bei einem CSV-Import auftreten können.

„Invalid CSV format"

Mögliche Ursachen:

  • Die Datei enthält falsche Trennzeichen
  • Die Datei ist als Excel-Datei statt als CSV gespeichert
  • Die erste Zeile enthält keine korrekten Spaltennamen

„Missing required field"

Dies bedeutet, dass ein erforderliches Feld in der CSV-Datei fehlt.

Prüfe:

  • Ob alle erforderlichen Spalten vorhanden sind
  • Ob die Spaltennamen exakt der erforderlichen Struktur entsprechen
  • Ob keine Tippfehler in den Spaltennamen enthalten sind

„Invalid value" oder „Validation error"

Diese Meldung erscheint, wenn ein Wert nicht den Validierungsregeln entspricht.

Beispiele:

  • Eine ungültige E-Mail-Adresse
  • Ein Datum in einem falschen Format
  • Ein Feld mit Text, wo ein numerischer Wert erwartet wird

„Duplicate entry"

Dies bedeutet, dass ein Wert, der eindeutig sein muss, bereits existiert.

Zum Beispiel:

  • Eine E-Mail-Adresse, die bereits im System vorhanden ist
  • Eine Benutzer-ID, die bereits existiert

Prüfpunkte, wenn ein Import nicht gelingt

Schlägt ein CSV-Import ohne klare Fehlermeldung fehl, prüfe folgende Punkte:

  • Die CSV-Datei enthält keine versteckten Zeichen
  • Die Datei ist in UTF-8-Kodierung gespeichert
  • Die Spaltenreihenfolge entspricht der erwarteten Importstruktur
  • Es gibt keine doppelten Werte in Feldern, die eindeutig sein müssen (zum Beispiel E-Mail-Adressen)

Es kann auch helfen:

  • Die CSV-Datei erneut zu speichern
  • Den Import mit einer kleinen Testdatei zu testen (zum Beispiel 1–2 Zeilen)

Tipps & Tricks für einen erfolgreichen CSV-Import

Um Importprobleme zu vermeiden, kannst du folgende Best Practices anwenden:

  • Verwende bevorzugt Excel oder Google Sheets, um die CSV-Datei zu erstellen
  • Prüfe immer, ob die Spaltennamen exakt übereinstimmen mit der erforderlichen Struktur
  • Vermeide Sonderzeichen wie zusätzliche Anführungszeichen oder unnötige Leerzeichen
  • Prüfe, ob keine leeren Zeilen am Ende der Datei vorhanden sind

Es kann auch helfen, eine bestehende, funktionierende CSV-Datei als Vorlage zu verwenden.

Fehlerbehebung über die Browserkonsole

Schlägt ein Import weiterhin ohne klare Fehlermeldung fehl, findest du zusätzliche Informationen über die Browserkonsole.

Folge dazu diesen Schritten:

  • Öffne die Seite, auf der du den CSV-Import durchführst
  • Öffne die Developer Tools in deinem Browser
    • Windows: F12 oder Strg + Umschalt + I
    • Mac: Cmd + Option + I
  • Gehe zum Tab Console
  • Führe den CSV-Import erneut aus
  • Prüfe, ob Fehlermeldungen (Errors) in der Konsole erscheinen

Achte besonders auf Meldungen wie:

  • 400 / 422 Errors → Problem mit den Daten in der CSV-Datei
  • Validation Errors → ein Feld entspricht nicht den erforderlichen Regeln
  • Network Errors → Problem beim Hochladen der Datei

Wenn du Kontakt mit dem Support aufnimmst, hilft es:

  • einen Screenshot des Konsolenfehlers mitzusenden
  • die verwendete CSV-Datei hinzuzufügen
  • anzugeben, welchen Import du durchzuführen versuchst

So kann schneller festgestellt werden, wo das Problem liegt.