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

System.IO.FileNotFoundException: The configuration file 'magazin.json' was not found and is not optional. The expected physical path was '/app/magazin.json'.

Pe scurt

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

Greșit
C#
<!-- magazin.json nu are setare de copiere în .csproj -->
Corect
C#
<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

Greșit
C#
builder.Configuration.AddJsonFile("magazin.local.json");
Corect
C#
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

Greșit
C#
builder.Configuration.AddJsonFile("Magazin.json"); // fișierul: magazin.json
Corect
C#
builder.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ă tu

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.

Codul care dă eroarea
C#
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();
După reparație, programul afișează
GET /nume → 200 OK
Magazin: TechShop
Indiciu

AddJsonFile are un parametru optional.

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 .csproj că 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

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