System.Globalization.CultureNotFoundException: Only the invariant culture is supported in globalization-invariant mode. See https://aka.ms/GlobalizationInvariantMode for more information. (Parameter 'name')
Aplicația rulează în modul „globalization-invariant” (de obicei în Docker sau pe Linux fără biblioteca ICU), iar codul cere o cultură concretă, de exemplu `new CultureInfo("ro-RO")`. Instalează ICU în imagine și setează `InvariantGlobalization` pe `false`, sau formatează fără cultură, cu un `NumberFormatInfo` propriu.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Pentru culturi (formatul numerelor, al datelor, compararea textului în română), .NET folosește pe Linux și macOS biblioteca ICU. Dacă ICU lipsește sau proiectul are <InvariantGlobalization>true</InvariantGlobalization> (setarea e implicită în unele șabloane și imagini Docker mici, de exemplu cele Alpine sau „chiseled”), runtime-ul cunoaște doar cultura invariantă. Orice cerere pentru ro-RO, en-US și așa mai departe aruncă CultureNotFoundException: Only the invariant culture is supported in globalization-invariant mode..
Codul merge pe calculatorul tău, dar pică în container, în CI sau pe server, iar mesajul apare la prima formatare cu cultură.
Variante de reparație:
- dacă ai nevoie de culturi reale: instalezi ICU în imagine (
apk add icu-libspe Alpine,libicupe Debian/Ubuntu) și puiInvariantGlobalizationpefalsesau variabila de mediuDOTNET_SYSTEM_GLOBALIZATION_INVARIANT=false; - dacă ai nevoie doar de un format fix: folosești
CultureInfo.InvariantCulturesau unNumberFormatInfoconstruit de tine.
Alt mesaj, Culture is not supported, apare când numele culturii e greșit (de exemplu ro_RO în loc de ro-RO).
De ce apare: cauzele frecvente
1Cultură concretă cerută în modul invariant
var ro = new CultureInfo("ro-RO");
Console.WriteLine(pret.ToString("N2", ro));var ro = new NumberFormatInfo { NumberDecimalSeparator = ",", NumberGroupSeparator = "." };
Console.WriteLine(pret.ToString("N2", ro));Un NumberFormatInfo propriu nu depinde de ICU, deci funcționează și în modul invariant.
2Imagine Docker fără ICU
FROM mcr.microsoft.com/dotnet/aspnet:9.0-alpine
# lipseste ICUFROM mcr.microsoft.com/dotnet/aspnet:9.0-alpine
RUN apk add --no-cache icu-libs
ENV DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=falseCu ICU instalat și modul invariant oprit, culturile reale devin disponibile.
3Setarea din proiect
<InvariantGlobalization>true</InvariantGlobalization><InvariantGlobalization>false</InvariantGlobalization>Setarea din .csproj decide dacă aplicația încarcă datele de cultură.
Repară eroarea, direct în pagină
Programul afișează un preț în formatul românesc, dar rulează în modul invariant și se oprește cu System.Globalization.CultureNotFoundException: Only the invariant culture is supported in globalization-invariant mode. Repară formatarea fără CultureInfo("ro-RO"), ca programul să afișeze Pret: 1.234,50 lei.
using System.Globalization;
decimal pret = 1234.5m;
var ro = new CultureInfo("ro-RO");
Console.WriteLine($"Pret: {pret.ToString("N2", ro)} lei");Pret: 1.234,50 lei
Indiciu
Separatorii pot fi dați printr-un NumberFormatInfo construit de tine.
Reparația
using System.Globalization;
decimal pret = 1234.5m;
var ro = new NumberFormatInfo { NumberDecimalSeparator = ",", NumberGroupSeparator = "." };
Console.WriteLine($"Pret: {pret.ToString("N2", ro)} lei");De ce merge
În modul invariant nu există culturi concrete, deci new CultureInfo("ro-RO") aruncă excepția. Un NumberFormatInfo cu virgulă ca separator zecimal și punct pentru mii nu depinde de datele de cultură. Formatul N2 îl folosește și produce 1.234,50. Într-o aplicație reală, alternativa e să instalezi ICU și să oprești modul invariant.
Alte forme ale mesajului
System.Globalization.CultureNotFoundException: Culture is not supported. (Parameter 'name') ro_RO is an invalid culture identifier.
Cum o eviți pe viitor
- Decide de la început dacă aplicația are nevoie de culturi (afișare pentru utilizatori) sau doar de formate fixe (fișiere, API-uri).
- Pentru date care circulă între sisteme folosește mereu
CultureInfo.InvariantCulture. - Testează aplicația în aceeași imagine Docker în care rulează pe server, nu doar local.
Întrebări frecvente
De ce merge pe Windows și nu în Docker?
Windows are propriile date de cultură (NLS / ICU incluse în sistem). Imaginile Linux mici nu au ICU, iar unele activează implicit modul invariant ca să fie mai mici.
Ce pierd dacă rămân în modul invariant?
Formatele specifice fiecărei limbi (separatori, nume de luni, monede), compararea și sortarea textului după regulile limbii (de exemplu pentru ș și ț) și conversiile de majuscule specifice unei limbi. Pentru un API intern de obicei nu contează.
Erori înrudite
System.FormatException: The input string 'abc' was not in a correct format. `int.Parse` (sau `double.Parse`, `Convert.ToInt32`) a primit un text care nu este un număr valid: litere, șir gol, zecimale într-un `int`. Folosește `int.TryParse(text, out int n)` și tratează cazul în care întoarce `false`. System.TypeInitializationException: The type initializer for 'Config' threw an exception. Inițializarea statică a unei clase (câmpurile `static` cu valori sau constructorul `static`) a aruncat o excepție. Cauza reală e în `InnerException`, pe rândul cu `--->` din mesaj. Repar-o acolo (de obicei un `Parse`, o cheie lipsă din configurare sau un fișier negăsit). System.FormatException: Format specifier was invalid. Ai cerut un format numeric care nu există pentru acel tip, de exemplu `"D2"` sau `"X2"` pe un `decimal` / `double` (aceste formate merg doar pe întregi). Pentru zecimale folosește `"F2"`, `"N2"` sau `"0.00"`, iar pentru `D` și `X` convertește întâi la `int`. Învață C# de la zero, cu exerciții la fiecare lecție
Curs C#: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
