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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
builder.Configuration.GetSection("X") nu aruncă niciodată: dacă secțiunea lipsește, întoarce o secțiune goală, iar valorile rămân null sau 0. GetRequiredSection("X") (din .NET 6) e varianta strictă: aruncă Section 'X' not found in configuration. dacă nu există nicio cheie sub acel nume.
Eroarea apare la pornire, în Program.cs. Cauzele tipice: secțiunea are alt nume în fișier (majusculele nu contează, dar Plata față de Plati da), secțiunea e doar în appsettings.Production.json iar tu rulezi în Development, sau fișierul nu ajunge în folderul de publicare.
E o eroare bună: îți spune clar ce lipsește, în loc să pornești cu valori goale.
De ce apare: cauzele frecvente
1Numele secțiunii diferă
// appsettings.json: { "Plata": { "Moneda": "RON" } }
var s = builder.Configuration.GetRequiredSection("Plati");// appsettings.json: { "Plati": { "Moneda": "RON" } }
var s = builder.Configuration.GetRequiredSection("Plati");Numele din cod și din fișier trebuie să fie același (fără să conteze majusculele).
2Secțiunea există doar într-un fișier de mediu
// doar în appsettings.Production.json
// rulezi cu ASPNETCORE_ENVIRONMENT=Development// pune valorile comune în appsettings.json,
// iar în appsettings.Production.json doar ce diferăappsettings.{Mediu}.json e citit doar pentru mediul curent. Valorile necesare peste tot stau în fișierul de bază.
Repară eroarea, direct în pagină
Aplicația nu pornește: GetRequiredSection("Plati") nu găsește secțiunea, pentru că în appsettings.json ea se numește Plata. Folosește în cod numele existent al secțiunii, ca GET /moneda să răspundă Moneda: RON.
var builder = WebApplication.CreateBuilder(args);
var plati = builder.Configuration.GetRequiredSection("Plati");
var moneda = plati["Moneda"];
var app = builder.Build();
app.MapGet("/moneda", () => $"Moneda: {moneda}");
app.Run();GET /moneda → 200 OK Moneda: RON
Indiciu
Uită-te în appsettings.json la numele exact al secțiunii.
Reparația
var builder = WebApplication.CreateBuilder(args);
var plati = builder.Configuration.GetRequiredSection("Plata");
var moneda = plati["Moneda"];
var app = builder.Build();
app.MapGet("/moneda", () => $"Moneda: {moneda}");
app.Run();De ce merge
GetRequiredSection caută exact numele dat (fără să țină cont de majuscule) și aruncă dacă nu găsește nicio cheie sub el. Fișierul are secțiunea Plata, deci cu acest nume citirea reușește. În proiectul tău, alege un singur nume și folosește-l peste tot, ideal dintr-o constantă.
Cum o eviți pe viitor
- Folosește
GetRequiredSectionpentru secțiunile fără de care aplicația nu are sens: eroarea e clară și apare devreme. - Ține numele secțiunii într-o constantă a clasei de setări.
- Pune în
appsettings.jsontoate cheile, cu valori de dezvoltare, iar în fișierele de mediu doar suprascrierile. - Pentru setări validate, combină cu Options și
ValidateOnStart.
Întrebări frecvente
E sensibil la majuscule?
Nu. Cheile de configurare din .NET nu țin cont de majuscule: plati, Plati și PLATI sunt aceeași secțiune.
O secțiune goală, {}, contează ca existentă?
Nu. O secțiune există doar dacă are o valoare sau cel puțin o cheie copil. Un obiect gol în JSON nu adaugă nicio cheie, deci tot primești eroarea.
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.IO.FileNotFoundException: The configuration file 'magazin.json' was not found and is not optional. The expected physical path was '/app/magazin.json'. Ai adăugat un fișier de configurare cu AddJsonFile("magazin.json"), dar fișierul nu există în folderul aplicației (calea fizică e afișată în mesaj). Adaugă fișierul și setează-l să fie copiat la build, sau marchează-l opțional: AddJsonFile("magazin.json", optional: true). 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. Î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.
