...
Eroare C# · Excepții la rulare: null, conversii, aritmetică

System.Globalization.CultureNotFoundException: Only the invariant culture is supported in globalization-invariant mode. See https://aka.ms/GlobalizationInvariantMode for more information. (Parameter 'name')

Pe scurt

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-libs pe Alpine, libicu pe Debian/Ubuntu) și pui InvariantGlobalization pe false sau variabila de mediu DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=false;
  • dacă ai nevoie doar de un format fix: folosești CultureInfo.InvariantCulture sau un NumberFormatInfo construit 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

Greșit
C#
var ro = new CultureInfo("ro-RO");
Console.WriteLine(pret.ToString("N2", ro));
Corect
C#
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

Greșit
C#
FROM mcr.microsoft.com/dotnet/aspnet:9.0-alpine
# lipseste ICU
Corect
C#
FROM mcr.microsoft.com/dotnet/aspnet:9.0-alpine
RUN apk add --no-cache icu-libs
ENV DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=false

Cu ICU instalat și modul invariant oprit, culturile reale devin disponibile.

3Setarea din proiect

Greșit
C#
<InvariantGlobalization>true</InvariantGlobalization>
Corect
C#
<InvariantGlobalization>false</InvariantGlobalization>

Setarea din .csproj decide dacă aplicația încarcă datele de cultură.

Repară tu

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.

Codul care dă eroarea
C#
using System.Globalization;

decimal pret = 1234.5m;
var ro = new CultureInfo("ro-RO");
Console.WriteLine($"Pret: {pret.ToString("N2", ro)} lei");
După reparație, programul afișează
Pret: 1.234,50 lei
Indiciu

Separatorii pot fi dați printr-un NumberFormatInfo construit de tine.

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

← Toate erorile C#

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.