FfFilenameFixer
← Alle Artikel

Umlaute im Dateinamen beim Upload kaputt: 5 Fälle gelöst

Wenn Sie eine Datei vom Mac auf eine Website hochladen und dort die Umlaute im Dateinamen plötzlich merkwürdig aussehen, der Download-Link „Datei nicht gefunden“ meldet oder die Suche die Datei schlicht nicht findet, steckt fast immer dasselbe dahinter: ein NFD/NFC-Problem. macOS speichert Umlaute, Akzente und nicht-lateinische Zeichen in einer zerlegten Unicode-Form (NFD), während die meisten Webserver, Content-Management-Systeme und Browser die zusammengesetzte Form (NFC) erwarten. Die Lösung ist, die Datei vor dem Hochladen in NFC umzubenennen oder den Server beim Empfang normalisieren zu lassen. Unten finden Sie die fünf Symptome, die dieses Problem auf Websites auslöst, was jedes davon bedeutet und wie Sie es am schnellsten beheben.

Wie das Problem mit Umlauten im Dateinamen entsteht

Ein Zeichen wie ü lässt sich in Unicode auf zwei Arten schreiben. Die zusammengesetzte Variante ist ein einziger Codepunkt, U+00FC. Die zerlegte Variante besteht aus zwei Teilen: einem normalen u, gefolgt von einem kombinierenden Trema. Auf dem Bildschirm sehen beide identisch aus. Bei Koreanisch passiert dasselbe in größerem Maßstab: 한글 kann als zwei fertige Silbenblöcke oder als Kette einzelner Jamo gespeichert werden. Japanische Kana mit Dakuten, etwa が, können ein Zeichen sein oder か plus ein separates Stimmhaftigkeitszeichen.

macOS hat beim Speichern solcher Dateinamen traditionell die zerlegte Form (NFD) erzeugt. Fast alles andere, also Windows, Linux-Server, PHP, Node, Python-Webframeworks und die Browser, die das Ergebnis anzeigen, geht von NFC aus. Landet ein NFD-Name in einem System, das NFC erwartet, „repariert“ das System nichts; es behandelt den Namen schlicht als eine andere Zeichenkette. Diese eine Abweichung erklärt jedes der folgenden Symptome.

Betroffen ist jeder, dessen Dateinamen Zeichen außerhalb des ASCII-Bereichs enthalten: ein Dokument namens Lebenslauf_Jürgen_Müller.pdf, ein Foto namens Geburtstag_Jörg.jpg, eine Rechnung Straßenbau_Angebot_März.xlsx, eine Tabelle vom koreanischen Kollegen namens 예산안_2026.xlsx oder ein japanisches PDF namens がいよう.pdf. Bestehen Ihre Dateinamen nur aus ASCII-Zeichen (bericht_2026.pdf), betrifft Sie nichts davon.

Die fünf Symptome und jeweils die Lösung

1. Umlaute oder Akzente erscheinen nach dem Upload abgetrennt

Was Sie sehen: Die Dateiliste in Ihrem CMS, Ihrer Lernplattform (etwa Moodle oder ILIAS) oder im Kundenportal zeigt Mu¨ller.pdf mit frei schwebenden Punkten, oder ein koreanischer Name erscheint als ㅎㅏㄴㄱㅡㄹ.docx mit einzeln aufgereihten Buchstaben. Auf anderen Systemen sieht der Name normal aus.

Warum: Die Schriftart oder Darstellungsebene der Website weiß nicht, wie sie den Grundbuchstaben mit dem separaten kombinierenden Zeichen verbinden soll, und zeichnet beide nebeneinander.

Lösung: Datei vor dem Hochladen in NFC umbenennen und erneut hochladen. Lässt die Plattform das Löschen des fehlerhaften Eintrags nicht zu, bitten Sie den Administrator darum, denn der Upload der korrigierten Version legt sonst wahrscheinlich eine zweite Datei an, statt die erste zu ersetzen (siehe Symptom 4).

2. Der Download-Link liefert 404 oder „Datei nicht gefunden“

Was Sie sehen: Die Datei wurde ohne Fehlermeldung hochgeladen und erscheint in der Mediathek. Ein Klick auf den Link bringt einen 404-Fehler oder die Meldung, die Datei existiere nicht.

Warum: Der Server hat die Datei unter ihrem NFD-Namen abgelegt, aber der erzeugte Link oder der Datenbankeintrag wurde irgendwo unterwegs nach NFC normalisiert. Die URL zeigt auf einen Namen, der sich von der tatsächlichen Datei auf der Festplatte um eine Bytefolge unterscheidet. In der Adresszeile sehen beide gleich aus.

Lösung: Im Einzelfall mit NFC-Namen erneut hochladen. Tritt das auf Ihrer eigenen Website auf, gehört die eigentliche Lösung auf den Server: jeden eingehenden Dateinamen vor dem Speichern nach NFC normalisieren. In Python ist das unicodedata.normalize("NFC", name), in JavaScript name.normalize("NFC"), in PHP Normalizer::normalize($name, Normalizer::FORM_C). Einmal an der Upload-Schnittstelle eingebaut, verschwindet das Problem für alle Nutzer.

3. Die Suche findet die Datei nicht, obwohl sie direkt davor steht

Was Sie sehen: Sie tippen Müller in das Suchfeld der Website oder drücken Strg+F in der Dateiliste, und nichts passt. Dabei ist die Datei in der Liste sichtbar.

Warum: Die Suche vergleicht Bytefolgen. Sie haben NFC eingegeben, gespeichert ist NFD. Die beiden sind nicht gleich, also gibt es keinen Treffer. Dasselbe passiert in manchen E-Mail-Programmen bei der Suche nach Anhängen.

Lösung: In NFC umbenennen und erneut hochladen. Als Notlösung suchen Sie nach dem Teil des Namens ohne Umlaut (ller statt Müller), der in beiden Formen gefunden wird.

4. „Eine Datei mit diesem Namen existiert bereits“ oder zwei scheinbar identische Dateien

Was Sie sehen: Die Plattform verweigert den Upload, oder Sie haben am Ende zwei Dateien mit exakt gleich aussehendem Namen.

Warum: Eine Kopie ist NFD, die andere NFC. Für das System sind das zwei verschiedene Namen; es erkennt also entweder einen Konflikt in einer Zuordnungstabelle oder speichert beide problemlos nebeneinander.

Lösung: Die NFD-Kopie löschen, die NFC-Kopie behalten. Können Sie die beiden per Augenschein nicht auseinanderhalten, laden Sie beide herunter und prüfen Sie sie (siehe „So erkennen Sie, in welcher Form ein Dateiname vorliegt“).

5. Skripte, Importe oder Formulare lehnen den Dateinamen ab

Was Sie sehen: Ein Massenimport, ein Formular mit Dateinamensprüfung oder ein Build-Skript bricht mit einer Meldung über ungültige Zeichen ab, obwohl der Name nur gewöhnliche Buchstaben enthält.

Warum: Prüfregeln auf Basis regulärer Ausdrücke erlauben häufig fertige Umlaute und Akzentbuchstaben, aber keine kombinierenden Zeichen. Ein zerlegtes ü enthält U+0308, das viele „nur Buchstaben“-Muster nicht durchlassen.

Lösung: Vor der Prüfung nach NFC normalisieren. Wenn Ihnen die Prüfroutine gehört: erst die Eingabe normalisieren, dann validieren.

So erkennen Sie, in welcher Form ein Dateiname vorliegt

Mit bloßem Auge geht es nicht, genau das ist ja das Problem. Drei verlässliche Prüfungen:

  1. Auf dem Mac im Terminal: ls | xxd | head. Ein zusammengesetztes ü erscheint als c3 bc. Ein zerlegtes als 75 cc 88 (das u, dann das kombinierende Trema).
  2. Unter Windows in PowerShell: [int[]][char[]]"Müller" gibt die Codepunkte aus. 252 ist zusammengesetzt; 117, 776 ist zerlegt.
  3. In jeder Browser-Konsole: "Müller".normalize("NFD") === "Müller" liefert true, wenn die eingefügte Zeichenkette bereits NFD ist.

Den Namen im Finder von Hand neu einzutippen ergibt mal NFC und mal nicht, je nach Dateisystem und Eingabeweg. Neu tippen ist deshalb allein keine verlässliche Lösung.

Dateinamen vor dem Upload gesammelt korrigieren

Bei ein oder zwei Dateien reicht es, den Namen an einem Windows-Rechner neu einzugeben oder nach dem Upload auf dem Server umzubenennen. Bei einem Ordner mit 80 Urlaubsfotos aus Südtirol mit Umlauten im Namen oder einem ganzen Semester koreanischer Kursunterlagen ist das nicht mehr praktikabel.

Möglichkeiten ganz ohne zusätzliches Werkzeug:

  • Nur ASCII-Namen verwenden. Juergen_Mueller_Lebenslauf.pdf kann dieses Problem nie bekommen. Für alles, was öffentlich verlinkt wird, ist das die robusteste Wahl.
  • Mit einem Einzeiler normalisieren. Auf macOS ist Python vorhanden: for f in *; do mv "$f" "$(python3 -c 'import sys,unicodedata;print(unicodedata.normalize("NFC",sys.argv[1]))' "$f")"; done. Das funktioniert, benennt aber auch Dinge um, die Sie nicht meinten, wenn Sie es im falschen Ordner ausführen.
  • Auf dem Server beheben. Wenn Sie die Website betreiben, schützt die Normalisierung beim Upload alle künftigen Nutzer, nicht nur Sie.

Wer keine Skripte ausführen möchte, kann FilenameFixer nutzen, eine kostenlose Web-App, die genau diese Umwandlung vornimmt. Sie ziehen die Dateien in den Browser, die App benennt sie gesammelt von NFD nach NFC um, und die Verarbeitung findet lokal im Browser statt, nicht auf einem Server. Sie akzeptiert außerdem eingefügten Text, was zum schnellen Prüfen eines einzelnen Namens praktisch ist, und kann Dateinamen innerhalb von ZIP-Archiven bis 200 MB wiederherstellen. Speziell für den Upload-Fall normalisiert die zugehörige Chrome-Erweiterung Dateinamen automatisch in dem Moment, in dem Sie sie auf einer Website hochladen, sodass die Symptome 1 bis 5 gar nicht erst auftreten. Die Seite ist auf Deutsch, Englisch, Koreanisch, Japanisch, Französisch, Spanisch und Vietnamesisch verfügbar.

Eine ehrliche Einschränkung: Keiner dieser Wege kann eine Datei reparieren, die bereits unter einem fehlerhaften Namen auf dem Server liegt. In dem Fall hilft nur Löschen und erneut Hochladen, oder Sie bitten den Betreiber der Website, die Datei direkt auf dem Server umzubenennen.

Kurzübersicht

Symptom Wo es auftritt Lösung
Abgetrennte Umlaute oder einzelne Buchstaben Dateiliste, Mediathek In NFC umbenennen, erneut hochladen
404 beim Download-Link Öffentliche URL, CMS Erneut hochladen; serverseitig normalisieren
Suche findet nichts Website-Suche, Strg+F, E-Mail In NFC umbenennen; nach dem Teil ohne Umlaut suchen
Duplikat oder „existiert bereits“ Uploads, freigegebene Ordner Die NFD-Kopie löschen

Sobald klar ist, dass zwei gleich aussehende Namen unterschiedliche Zeichenketten sein können, wird jedes dieser Symptome vorhersehbar. Normalisieren Sie nach NFC, bevor die Datei den Mac verlässt, oder direkt am Eingang des Servers, und die Website behandelt den Namen so, wie Sie es von Anfang an erwartet haben.