...
Eroare ASP.NET Core · Compilare și pornirea aplicației

System.InvalidOperationException: Build can only be called once.

Pe scurt

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

Greșit
C#
var app = builder.Build();
app.MapGet("/", () => "Salut");
var app2 = builder.Build();
app2.MapGet("/stare", () => "ok");
Corect
C#
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

Greșit
C#
var temp = builder.Build();
var cfg = temp.Services.GetRequiredService<IConfiguration>();
var app = builder.Build();
Corect
C#
var cfg = builder.Configuration;
var app = builder.Build();

Configurarea e disponibilă direct pe builder; nu e nevoie de o aplicație temporară.

Repară tu

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.

Codul care dă eroarea
C#
var builder = WebApplication.CreateBuilder(args);

var app = builder.Build();
app.MapGet("/", () => "Magazin online");

var app2 = builder.Build();
app2.MapGet("/stare", () => "ok");

app.Run();
După reparație, programul afișează
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.

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.cs caută Build(): trebuie să apară o singură dată.
  • Pentru setări la pornire folosește builder.Configuration și builder.Environment.
  • Pentru inițializări care au nevoie de servicii (de exemplu crearea bazei de date), fă-le după Build(), într-un app.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

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