...
Eroare ASP.NET Core · Configurare, Options și logging

System.InvalidOperationException: Failed to convert configuration value 'zece' at 'Cos:MaxProduse' to type 'System.Int32'.

Pe scurt

O valoare din configurare nu poate fi transformată în tipul cerut: ai cerut int, dar în appsettings.json sau în variabila de mediu e un text ("zece", "20 buc", "1,5"). Corectează valoarea din configurare ca să fie în formatul tipului.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Configurarea .NET ține toate valorile ca text. Când le citești cu GetValue<int>("Cos:MaxProduse"), Get<T>(), Bind sau Options, textul e convertit în tipul proprietății. Dacă textul nu e valid pentru acel tip, primești Failed to convert configuration value 'zece' at 'Cos:MaxProduse' to type 'System.Int32'.

Mesajul îți dă tot ce-ți trebuie: valoarea problematică ('zece'), calea completă a cheii (Cos:MaxProduse) și tipul așteptat. Caută cheia în appsettings.json, în appsettings.{Mediu}.json, în variabilele de mediu (Cos__MaxProduse) și în argumentele din linia de comandă: ultima sursă câștigă.

Capcane frecvente: zecimale cu virgulă (1,5 pentru decimal; conversia folosește cultura invariantă, cu punct), bool scris da, TimeSpan scris 30s în loc de 00:00:30, enum cu nume greșit.

De ce apare: cauzele frecvente

1Text în loc de număr

Greșit
C#
{ "Cos": { "MaxProduse": "zece" } }
Corect
C#
{ "Cos": { "MaxProduse": 10 } }

int acceptă doar cifre. În JSON poți scrie numărul și fără ghilimele.

2Zecimale cu virgulă

Greșit
C#
{ "Livrare": { "Taxa": "15,5" } }
Corect
C#
{ "Livrare": { "Taxa": "15.5" } }

Conversia folosește cultura invariantă: separatorul zecimal e punctul, indiferent de setările regionale.

3Variabila de mediu suprascrie cu o valoare greșită

Greșit
C#
Cos__MaxProduse=10 bucati
Corect
C#
Cos__MaxProduse=10

Variabilele de mediu au prioritate față de appsettings.json. Dacă fișierul e corect, verifică mediul.

Repară tu

Repară eroarea, direct în pagină

Aplicația nu pornește: variabila de mediu Cos__MaxProduse are valoarea zece, iar codul o citește ca int. Valoarea corectă (10) este în appsettings.json. Citește mai întâi configurarea fără variabila greșită: pune în cod, după CreateBuilder, o sursă în memorie care suprascrie cheia cu 10, ca GET /cos/limita să răspundă Maxim 10 produse în coș.

Codul care dă eroarea
C#
var builder = WebApplication.CreateBuilder(args);
// TODO: suprascrie Cos:MaxProduse cu o valoare validă
var max = builder.Configuration.GetValue<int>("Cos:MaxProduse");
var app = builder.Build();

app.MapGet("/cos/limita", () => $"Maxim {max} produse în coș");

app.Run();
După reparație, programul afișează
GET /cos/limita → 200 OK
Maxim 10 produse în coș
Indiciu

Ultima sursă de configurare adăugată câștigă: builder.Configuration.AddInMemoryCollection(...).

Alte forme ale mesajului

  • System.InvalidOperationException: Failed to convert configuration value at 'Cos:MaxProduse' to type 'System.Int32'.

Cum o eviți pe viitor

  • Scrie numerele și valorile bool în JSON fără ghilimele, ca editorul să le vadă ca număr.
  • Folosește punctul pentru zecimale și formatul hh:mm:ss pentru TimeSpan.
  • Validează setările la pornire (Options + ValidateOnStart).
  • Când o valoare „corectă” tot dă eroare, caută sursele cu prioritate mai mare: mediu, argumente, User Secrets.

Întrebări frecvente

De ce nu se folosește valoarea implicită când conversia eșuează?

Valoarea implicită din GetValue<int>("cheie", 5) se folosește doar când cheia lipsește. O cheie existentă cu un text invalid e tratată ca greșeală și aruncă.

Cum găsesc sursa care a dat valoarea?

Pe IConfigurationRoot poți apela GetDebugView(): afișează fiecare cheie cu valoarea și sursa ei. Nu-l lăsa în producție, pentru că arată și secretele.

Erori înrudite

← Toate erorile ASP.NET Core

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ță ASP.NET Core de la zero, cu exerciții la fiecare lecție

Curs ASP.NET Core: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 20 lecții sunt gratuite.