System.InvalidOperationException: Failed to convert configuration value 'zece' at 'Cos:MaxProduse' to type 'System.Int32'.
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
{ "Cos": { "MaxProduse": "zece" } }{ "Cos": { "MaxProduse": 10 } }int acceptă doar cifre. În JSON poți scrie numărul și fără ghilimele.
2Zecimale cu virgulă
{ "Livrare": { "Taxa": "15,5" } }{ "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ă
Cos__MaxProduse=10 bucatiCos__MaxProduse=10Variabilele de mediu au prioritate față de appsettings.json. Dacă fișierul e corect, verifică mediul.
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ș.
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();GET /cos/limita → 200 OK Maxim 10 produse în coș
Indiciu
Ultima sursă de configurare adăugată câștigă: builder.Configuration.AddInMemoryCollection(...).
Reparația
var builder = WebApplication.CreateBuilder(args);
builder.Configuration.AddInMemoryCollection(new Dictionary<string, string?>
{
["Cos:MaxProduse"] = "10"
});
var max = builder.Configuration.GetValue<int>("Cos:MaxProduse");
var app = builder.Build();
app.MapGet("/cos/limita", () => $"Maxim {max} produse în coș");
app.Run();De ce merge
Variabilele de mediu aveau prioritate față de fișier și aduceau textul zece. O sursă adăugată după ele, aici în memorie, suprascrie cheia cu un număr valid, iar GetValue<int> reușește. În proiectul real, repari valoarea variabilei de mediu; exercițiul arată regula de prioritate: ultima sursă câștigă.
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:sspentruTimeSpan. - 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
Microsoft.Extensions.Options.OptionsValidationException: DataAnnotation validation failed for 'SetariEmail' members: 'Expeditor' with the error: 'The Expeditor field is required.'. Setările legate cu ValidateDataAnnotations nu respectă atributele clasei: o valoare [Required] lipsește sau un [Range] e depășit în appsettings.json ori în variabilele de mediu. Mesajul spune clasa, proprietatea și regula. Completează valoarea în configurare, nu șterge validarea. System.InvalidOperationException: Section 'Plati' not found in configuration. GetRequiredSection("Plati") nu a găsit secțiunea în nicio sursă de configurare: lipsește din appsettings.json, e scrisă altfel sau e doar în appsettings.Production.json. Adaugă secțiunea sau corectează numele. System.InvalidOperationException: Cannot create instance of type 'SetariFacturare' because it is missing a public parameterless constructor. Legarea configurării (Get<T>, Bind, Configure<T>) trebuie să creeze obiectul de setări, dar clasa nu are un constructor public fără parametri pe care să-l poată folosi. Adaugă un constructor public fără parametri sau folosește proprietăți cu set/init și valori implicite. Î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.
