
Im Türkischen ist der Kleinbuchstabe von „I“ das „ı“ und der Großbuchstabe von „i“ das „İ“. Kulturabhängige ToLower()-, ToUpper()- oder Groß-/Kleinschreibung ignorierende Vergleiche machen in einer tr-TR-Umgebung aus „FILE“ ein „fıle“, und „[email protected]“ stimmt nicht mehr mit „[email protected]“ überein. Die Lösung: Verwenden Sie für Bezeichner, Schlüssel, E-Mail-Adressen und Protokollzeichenfolgen kulturunabhängige (ordinale/invariante) Vergleiche und wählen Sie die Datenbanksortierung (Collation) bewusst.
Symptome: „Invalid column name“, nicht gefundene E-Mails, defekte Suche
- Eine Anwendung, die auf dem Rechner des Entwicklers einwandfrei läuft, verhält sich auf einem Server oder Client mit türkischer Regionseinstellung anders.
- Ein Benutzer, der seine E-Mail-Adresse in Großbuchstaben eingibt, kann sich nicht anmelden und erhält die Meldung „Benutzer nicht gefunden“.
- Die Suche nach „istanbul“ liefert keine Datensätze, die als „ISTANBUL“ gespeichert sind.
- Konfigurationsschlüssel oder Enum-Werte wie „File“, „Id“ oder „Info“ werden nicht erkannt.
- In einer SQL-Server-Datenbank mit türkischer Sortierung bricht eine Abfrage ab mit: „Msg 207, Level 16: Invalid column name ’musteriid’.“ oder „Msg 208: Invalid object name ’dbo.MUSTERI’.“
- Dieselbe Abfrage läuft auf der Testdatenbank des Entwicklers mit englischer Sortierung fehlerfrei.
Ursache: Das Türkische kennt vier verschiedene „i“
In den meisten Sprachen mit lateinischem Alphabet sind „i“ (U+0069) und „I“ (U+0049) Klein- und Großform desselben Buchstabens. Im Türkischen (und Aserbaidschanischen) gibt es dagegen zwei getrennte Paare: „i“ mit „İ“ (U+0130) sowie „ı“ (U+0131) mit „I“. Die Unicode-Datei SpecialCasing.txt legt diese Regel ausdrücklich fest: Im Türkischen wird „I“ beim Kleinschreiben zum punktlosen „ı“ und „i“ beim Großschreiben zum „İ“ mit Punkt.
Microsoft Learn bezeichnet dies als „Turkish-I problem“ und nennt das klassische Beispiel: Ein IsFileURI(„file:“)-Aufruf, der mit einem Groß-/Kleinschreibung ignorierenden, aber kulturabhängigen Vergleich geschrieben ist, liefert unter englischer Kultur true und unter türkischer Kultur false. Laut Dokumentation kann dadurch auf türkischen Systemen sogar eine Sicherheitsprüfung umgangen werden, die mit „FILE:“ beginnende Adressen sperren soll. Die Java-Dokumentation warnt ebenso: „TITLE“.toLowerCase() liefert in türkischer Locale „tıtle“; für Bezeichner von Programmiersprachen, Protokollschlüssel und HTML-Tags soll Locale.ROOT verwendet werden.
Auf der Datenbankseite ist der Mechanismus derselbe. Wird SQL Server auf einem Server mit türkischem Betriebssystem-Gebietsschema installiert, wählt das Setup Turkish_CI_AS als Standardsortierung. Laut Microsoft-Dokumentation gilt die Datenbanksortierung nicht nur für Spaltendaten, sondern für alle Metadaten wie Tabellen- und Spaltennamen. „CI“ bedeutet zwar Groß-/Kleinschreibung ignorierend, doch nach türkischen Regeln sind „i“ und „I“ keine zwei Formen desselben Buchstabens. Daher ist unter Turkish_CI_AS N’i’ = N’I’ falsch und N’i’ = N’İ’ wahr, und wer eine Spalte namens MusteriID als „musteriid“ anspricht, erhält Fehler 207.
Das Problem tritt nur bei Zeichenfolgen mit den Buchstaben „i/I“ auf. Da Felder wie „Name“ oder „Betrag“ weiter funktionieren, wirkt der Fehler oft zufällig und unerklärlich, und genau deshalb übersehen Tests ihn häufig.
Laut Microsoft-Leitfaden sind XML- und HTML-Tags, Benutzernamen, Dateipfade und die Namen von Systemobjekten kulturunabhängige Daten; werden sie kulturabhängig interpretiert, entstehen subtile Fehler, schlechte Leistung und in manchen Fällen Sicherheitsprobleme. Der Leitfaden hält außerdem fest, dass sich das Verhalten des Ordinal-Vergleichs nie ändert, während kulturabhängige Vergleiche sich mit Aktualisierungen von ICU und Windows NLS im Laufe der Zeit ändern können. Ein kulturabhängiger Vergleich, der heute die Tests besteht, kann also nach einem Plattformupdate ein anderes Ergebnis liefern.
Schritt-für-Schritt-Lösung
- Ermitteln Sie die Umgebung: Notieren Sie die Kultur von Server und Client, auf denen die Anwendung läuft (CultureInfo.CurrentCulture bzw. in Java Locale.getDefault()), sowie die Sortierung der Datenbank.
- Reproduzieren Sie das Problem: Führen Sie die kurzen Tests unten sowohl unter tr-TR als auch unter en-US aus und vergleichen Sie die Ergebnisse.
- Klassifizieren Sie Ihre Zeichenfolgen: Text, der Benutzern angezeigt und sprachlich sortiert wird (Produktnamen, Firmennamen), darf kulturabhängig bleiben; Bezeichner, E-Mail-Adressen, Benutzernamen, Dateipfade, URL-Schemata, Konfigurationsschlüssel, Enum-Namen und Protokollwerte müssen kulturunabhängig behandelt werden.
- Vergleichen Sie in .NET mit StringComparison.Ordinal oder StringComparison.OrdinalIgnoreCase und übergeben Sie Dictionaries und Sets StringComparer.OrdinalIgnoreCase. Wenn Sie normalisieren müssen, empfiehlt Microsoft ToUpperInvariant statt ToLowerInvariant.
- Lassen Sie in Java toLowerCase() und toUpperCase() nie ohne Parameter; verwenden Sie für kulturunabhängige Zeichenfolgen toLowerCase(Locale.ROOT).
- In JavaScript verwenden toUpperCase() und toLowerCase() die Standardzuordnung von Unicode; wenn Sie die türkische Regel wünschen, geben Sie die Locale ausdrücklich an (toLocaleUpperCase(„tr-TR“)). Andernfalls rufen Sie die toLocale…-Methoden nicht ohne Locale auf, da das Ergebnis sonst von der Browsersprache abhängt.
- Schreiben Sie in SQL Server Tabellen- und Spaltennamen im Code genau in der Schreibweise, in der das Objekt angelegt wurde. Wenn Sie in einem bestimmten Vergleich die türkische Regel nicht möchten, geben Sie in der Abfrage mit COLLATE eine andere Sortierung an.
- Führen Sie die Tests nach der Korrektur erneut unter tr-TR und gegen eine Turkish_CI_AS-Datenbank aus.
// C#: Problem nachstellen und beheben
CultureInfo.CurrentCulture = new CultureInfo("tr-TR");
Console.WriteLine("FILE".ToLower()); // fıle
Console.WriteLine("FILE".ToLowerInvariant()); // file
bool gleich = string.Equals(eingabe, gespeichert, StringComparison.OrdinalIgnoreCase);
string schluessel = email.Trim().ToUpperInvariant();
var einstellungen = new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase);// Java
"TITLE".toLowerCase(Locale.forLanguageTag("tr")); // tıtle
"TITLE".toLowerCase(Locale.ROOT); // title
// JavaScript
"FILE".toLocaleLowerCase("tr-TR"); // fıle
"istanbul".toLocaleUpperCase("tr-TR"); // İSTANBUL
"file".toUpperCase(); // FILE-- SQL Server: Sortierung und Verhalten prüfen (nur lesend)
SELECT SERVERPROPERTY('Collation') AS ServerSortierung,
DATABASEPROPERTYEX(DB_NAME(), 'Collation') AS DatenbankSortierung;
SELECT CASE WHEN N'i' = N'I' COLLATE Turkish_CI_AS THEN 'gleich' ELSE 'verschieden' END; -- verschieden
SELECT CASE WHEN N'i' = N'İ' COLLATE Turkish_CI_AS THEN 'gleich' ELSE 'verschieden' END; -- gleich
-- Türkische Regel für einen einzelnen Vergleich umgehen
SELECT * FROM dbo.Musteri
WHERE Eposta = @email COLLATE Latin1_General_100_CI_AS;Eine Änderung der Datenbanksortierung mit ALTER DATABASE ändert nicht die Sortierung bestehender Spalten; Microsoft weist ausdrücklich darauf hin. Bei Datenbanken von Standardsoftware wie ERP-Systemen sollten Sie die Sortierung nicht ohne Unterstützung des Herstellers ändern.
Dauerhafte Vorbeugung
- Speichern Sie E-Mail-Adressen und Benutzernamen bei der Registrierung kulturunabhängig normalisiert (zum Beispiel mit ToUpperInvariant) in einer eigenen Spalte und verwenden Sie für Suche und Anmeldung nur diese Spalte.
- Aktivieren Sie in .NET-Projekten die Codeanalyseregeln CA1307, CA1309 und CA1310; laut Microsoft finden sie unbeabsichtigt verwendete kulturabhängige Vergleiche.
- Verbieten Sie in Java-Projekten im Code-Review parameterlose toLowerCase()- und toUpperCase()-Aufrufe.
- Führen Sie Ihre Unit-Tests mindestens einmal unter tr-TR aus und ergänzen Sie Testdaten mit I, etwa „FILE“, „Id“ oder „ISMAIL“.
- Belassen Sie die Sortierung neuer Datenbanken nicht beim Installationsstandard; wählen Sie sie bewusst nach den Anforderungen der Anwendung und dokumentieren Sie sie.
- Schreiben Sie Objektnamen in SQL-Skripten immer genau so, wie sie angelegt wurden; wenn Sie ein ORM nutzen, definieren Sie die Namenszuordnung ausdrücklich.
Wann sollten Sie einen Experten hinzuziehen?
Wenn das Problem kritische Abläufe in einem produktiven ERP-System oder Kundenportal betrifft, etwa Anmeldung, Rechnungsabgleich oder Schnittstellen, wenn Sie eine Änderung der Sortierung oder eine Massennormalisierung von Daten erwägen oder wenn Ihr Zugriff auf den Quellcode eingeschränkt ist, ist fachliche Unterstützung der sicherere Weg. Bei solchen Problemen, denen wir in der Praxis bei Unternehmen in Denizli begegnen, unterstützt Workas Sie im Rahmen der individuellen Softwareentwicklung und plant Code-Review, Testszenarien und die datenbankseitige Korrektur gemeinsam.
Häufig gestellte Fragen
Löst es das Problem, die Kultur der Anwendung auf en-US zu stellen?
Es verdeckt das Symptom, ist aber keine dauerhafte Lösung; Datumsangaben, Zahlen und Sortierungen, die türkisch erscheinen sollen, gehen ebenfalls kaputt. Richtig ist, nur Bezeichner- und Schlüsselvergleiche ordinal bzw. invariant zu machen.
Warum wird ToUpperInvariant statt ToLowerInvariant empfohlen?
Der .NET-Leitfaden von Microsoft zum Zeichenfolgenvergleich empfiehlt ToUpperInvariant, wenn Zeichenfolgen für einen Vergleich normalisiert werden. Wo möglich, ist ein direkter OrdinalIgnoreCase-Vergleich besser als jede Normalisierung.
Ist die Sortierung Turkish_CI_AS falsch?
Nein. Sie wird für die korrekte Sortierung türkischer Texte benötigt. Das Problem entsteht, wenn sie auch auf sprachunabhängige Zeichenfolgen wie Bezeichner und Schlüssel angewendet wird und Objektnamen im Code in anderer Schreibweise stehen.
Tritt das Problem nur unter Windows auf?
Nein. .NET, Java und JavaScript wenden auf allen Plattformen dieselben türkischen Regeln an; sobald Kultur oder Locale türkisch ist, tritt das Problem unabhängig vom Betriebssystem auf.


