System.InvalidOperationException: Build can only be called once.
builder.Build() a fost apelat de două ori pe același WebApplicationBuilder. Un builder produce o singură aplicație: păstrează un singur var app = builder.Build(); și folosește aceeași variabilă app peste tot.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
WebApplicationBuilder.Build() construiește containerul de servicii, configurarea finală și aplicația. După primul apel, builder-ul e „consumat”: colecția de servicii devine read-only, iar un al doilea apel aruncă InvalidOperationException: Build can only be called once., chiar la pornire, înainte de orice cerere.
Greșeala apare de obicei din copy-paste (două blocuri care încep cu var app = builder.Build();), dintr-o metodă ajutătoare care face builder.Build() ca să obțină un serviciu în timpul configurării, sau din teste care refolosesc același builder. Stiva de apeluri arată linia celui de-al doilea Build().
Dacă ai nevoie de un serviciu în timpul configurării, nu construi aplicația de două ori: folosește builder.Configuration pentru setări sau amână logica după Build(), cu app.Services.
De ce apare: cauzele frecvente
1Două apeluri Build() în Program.cs
var app = builder.Build();
app.MapGet("/", () => "Salut");
var app2 = builder.Build();
app2.MapGet("/stare", () => "ok");var app = builder.Build();
app.MapGet("/", () => "Salut");
app.MapGet("/stare", () => "ok");O singură aplicație, cu toate endpoint-urile pe aceeași variabilă app.
2Build() folosit ca să citești un serviciu
var temp = builder.Build();
var cfg = temp.Services.GetRequiredService<IConfiguration>();
var app = builder.Build();var cfg = builder.Configuration;
var app = builder.Build();Configurarea e disponibilă direct pe builder; nu e nevoie de o aplicație temporară.
Repară eroarea, direct în pagină
Aplicația se oprește la pornire cu System.InvalidOperationException: Build can only be called once.. Repară Program.cs ca aceeași aplicație să răspundă la GET / cu Magazin online și la GET /stare cu ok.
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapGet("/", () => "Magazin online");
var app2 = builder.Build();
app2.MapGet("/stare", () => "ok");
app.Run();GET / → 200 OK Magazin online GET /stare → 200 OK ok
Indiciu
Un builder poate construi o singură aplicație; folosește aceeași variabilă pentru toate rutele.
Reparația
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapGet("/", () => "Magazin online");
app.MapGet("/stare", () => "ok");
app.Run();De ce merge
Al doilea builder.Build() arunca excepția, pentru că builder-ul fusese deja consumat la primul apel. Toate endpoint-urile trebuie adăugate pe aceeași instanță WebApplication. După ce elimini app2 și mapezi /stare pe app, aplicația pornește și răspunde la ambele rute. Codul de după Build() lucrează mereu cu aceeași instanță.
Alte forme ale mesajului
System.InvalidOperationException: The service collection cannot be modified because it is read-only.
Cum o eviți pe viitor
- În
Program.cscautăBuild(): trebuie să apară o singură dată. - Pentru setări la pornire folosește
builder.Configurationșibuilder.Environment. - Pentru inițializări care au nevoie de servicii (de exemplu crearea bazei de date), fă-le după
Build(), într-unapp.Services.CreateScope(). - În teste, creează un builder nou pentru fiecare aplicație.
Întrebări frecvente
Pot avea două aplicații în același proces?
Da, dar fiecare cu builder-ul ei: WebApplication.CreateBuilder(args) de două ori. De obicei nu ai nevoie: un singur WebApplication poate asculta pe mai multe porturi.
De ce eroarea apare înainte de prima cerere?
Build() rulează la pornire, ca instrucțiune obișnuită în Program.cs. Excepția oprește programul înainte să ajungă la app.Run().
Erori înrudite
error CS1929: 'IServiceProvider' does not contain a definition for 'AddScoped' and the best extension method overload 'ServiceCollectionServiceExtensions.AddScoped<X>(IServiceCollection)' requires a receiver of type 'Microsoft.Extensions.DependencyInjection.IServiceCollection' Ai încercat să înregistrezi un serviciu pe app.Services, care este containerul deja construit (IServiceProvider). Serviciile se adaugă pe builder.Services, înainte de builder.Build(). error CS1929: 'WebApplicationBuilder' does not contain a definition for 'MapGet' and the best extension method overload 'EndpointRouteBuilderExtensions.MapGet(IEndpointRouteBuilder, string, Delegate)' requires a receiver of type 'Microsoft.AspNetCore.Routing.IEndpointRouteBuilder' Ai apelat MapGet pe builder, dar rutele se definesc pe aplicația construită. Mută apelul după var app = builder.Build(); și scrie app.MapGet(...). Pe builder rămân doar serviciile, configurarea și logging-ul. 404 Not Found pentru un endpoint mapat după app.Run() app.Run() pornește serverul și blochează până la oprirea aplicației, deci liniile scrise după el nu rulează cât timp aplicația primește cereri. Endpoint-urile definite acolo nu există și răspund 404. Mută toate MapGet / MapPost înainte de app.Run(). Î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.
