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).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
builder.Configuration.AddJsonFile("magazin.json") înseamnă implicit optional: false: fișierul e obligatoriu. La pornire, dacă nu există la calea așteptată, aplicația se oprește cu FileNotFoundException, iar mesajul îți spune exact unde l-a căutat (The expected physical path was ...).
Calea este relativă la content root, adică folderul proiectului când rulezi cu dotnet run, sau folderul de publicare în producție. Cele mai dese cauze: fișierul nu e copiat în output la publicare (lipsește CopyToOutputDirectory în .csproj), numele e scris altfel (pe Linux contează majusculele: Magazin.json nu e magazin.json), sau aplicația e pornită dintr-un alt folder de lucru.
appsettings.json și appsettings.{Mediu}.json adăugate automat de CreateBuilder sunt opționale, deci lipsa lor nu dă această eroare.
De ce apare: cauzele frecvente
1Fișierul nu ajunge în folderul de publicare
<!-- magazin.json nu are setare de copiere în .csproj --><ItemGroup>
<Content Include="magazin.json" CopyToOutputDirectory="PreserveNewest" />
</ItemGroup>La dotnet publish, doar fișierele marcate pentru copiere ajung lângă aplicație.
2Fișierul e de fapt opțional
builder.Configuration.AddJsonFile("magazin.local.json");builder.Configuration.AddJsonFile("magazin.local.json", optional: true);Un fișier cu suprascrieri locale nu există pe server. Cu optional: true, lipsa lui e ignorată.
3Majuscule diferite pe Linux
builder.Configuration.AddJsonFile("Magazin.json"); // fișierul: magazin.jsonbuilder.Configuration.AddJsonFile("magazin.json");Windows nu face diferența între majuscule în numele fișierelor, Linux da. Codul care merge local poate pica în container.
Repară eroarea, direct în pagină
Aplicația adaugă magazin.local.json cu suprascrieri locale, dar fișierul nu există pe acest server, iar pornirea se oprește. Fă fișierul opțional, astfel încât GET /nume să folosească numele din appsettings.json și să răspundă Magazin: TechShop.
var builder = WebApplication.CreateBuilder(args);
builder.Configuration.AddJsonFile("magazin.local.json");
var app = builder.Build();
app.MapGet("/nume", (IConfiguration config) => $"Magazin: {config["Magazin:Nume"]}");
app.Run();GET /nume → 200 OK Magazin: TechShop
Indiciu
AddJsonFile are un parametru optional.
Reparația
var builder = WebApplication.CreateBuilder(args);
builder.Configuration.AddJsonFile("magazin.local.json", optional: true);
var app = builder.Build();
app.MapGet("/nume", (IConfiguration config) => $"Magazin: {config["Magazin:Nume"]}");
app.Run();De ce merge
Fișierele de suprascriere locale nu există în toate mediile. Cu optional: true, configurarea îl citește dacă există și îl ignoră altfel, iar valoarea vine din appsettings.json. Pentru fișierele fără de care aplicația nu poate funcționa, păstrează optional: false: eroarea timpurie e utilă.
Alte forme ale mesajului
System.IO.FileNotFoundException: The configuration file 'appsettings.Local.json' was not found and is not optional. The expected physical path was 'C:\app\appsettings.Local.json'.
Cum o eviți pe viitor
- Decide explicit pentru fiecare fișier dacă e obligatoriu (
optional: false) sau nu. - Verifică în
.csprojcă fișierele de configurare proprii sunt copiate la publicare. - Folosește numai litere mici în numele fișierelor, ca să nu ai surprize pe Linux.
- Pentru setări de mediu, preferă
appsettings.{Mediu}.jsonși variabilele de mediu.
Întrebări frecvente
De ce merge local și nu în Docker?
Fie fișierul nu e copiat în imagine (publicarea nu l-a inclus), fie numele diferă prin majuscule și sistemul de fișiere din container, Linux, face diferența.
Ce înseamnă reloadOnChange?
Cu reloadOnChange: true, modificările fișierului sunt citite fără repornire și ajung în IOptionsMonitor sau IOptionsSnapshot. Nu influențează faptul că fișierul e obligatoriu.
Erori înrudite
System.IO.InvalidDataException: Failed to load configuration from file '/app/appsettings.json'. Fișierul de configurare există, dar nu e JSON valid: lipsește o virgulă sau o ghilimea, ai o virgulă în plus ori o acoladă neînchisă. Deschide fișierul indicat, găsește greșeala de sintaxă (excepția interioară spune linia) și corecteaz-o. 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. Î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.
