error CS4034: The 'await' operator can only be used within an async lambda expression. Consider marking this lambda expression with the 'async' modifier.
Folosești await într-un handler scris ca lambda fără cuvântul async. Pune async înaintea parametrilor: app.MapGet("/x", async (MagazinDb db) => await db.Produse.ToListAsync()). ASP.NET Core așteaptă singur Task-ul întors.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
await poate apărea doar într-o funcție marcată async, iar regula se aplică și lambda-urilor date lui MapGet, MapPost, app.Use sau Select. Handler-ele din ASP.NET Core sunt des asincrone (EF Core cu ToListAsync, SaveChangesAsync, citirea corpului cu ReadFromJsonAsync), deci eroarea apare imediat ce transformi un handler sincron în unul asincron și uiți modificatorul.
Mesajul îți dă și soluția: „Consider marking this lambda expression with the 'async' modifier”. Cu async, lambda întoarce Task<T>, iar Minimal APIs știe să aștepte rezultatul înainte să scrie răspunsul. Nu e nevoie de .Result sau .Wait(): acestea blochează un fir de execuție pentru fiecare cerere și pot reduce mult capacitatea serverului.
De ce apare: cauzele frecvente
1Handler fără async
app.MapGet("/produse", (MagazinDb db) => await db.Produse.ToListAsync());app.MapGet("/produse", async (MagazinDb db) => await db.Produse.ToListAsync());async permite await în lambda și face ca handler-ul să întoarcă un Task, pe care ASP.NET Core îl așteaptă.
2Middleware inline fără async
app.Use((context, next) =>
{
context.Response.Headers["X-Magazin"] = "demo";
await next(context);
});app.Use(async (context, next) =>
{
context.Response.Headers["X-Magazin"] = "demo";
await next(context);
});Delegatul middleware-ului este asincron; modificatorul trebuie pus pe lambda.
Repară eroarea, direct în pagină
Handler-ul POST /comenzi citește comanda cu await, dar programul nu compilează: CS4034: The 'await' operator can only be used within an async lambda expression. Repară-l ca cererea să răspundă Comandă primită: 3 x Mouse.
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapPost("/comenzi", (HttpRequest request) =>
{
var comanda = await request.ReadFromJsonAsync<Comanda>();
return $"Comandă primită: {comanda!.Cantitate} x {comanda.Produs}";
});
app.Run();
record Comanda(string Produs, int Cantitate);POST /comenzi → 200 OK Comandă primită: 3 x Mouse
Indiciu
Lambda care conține await trebuie marcată cu un modificator.
Reparația
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapPost("/comenzi", async (HttpRequest request) =>
{
var comanda = await request.ReadFromJsonAsync<Comanda>();
return $"Comandă primită: {comanda!.Cantitate} x {comanda.Produs}";
});
app.Run();
record Comanda(string Produs, int Cantitate);De ce merge
await este permis doar în funcții async. Adăugând async înaintea listei de parametri, lambda devine asincronă și întoarce Task<string>. Minimal APIs așteaptă acest Task și abia apoi scrie textul în răspuns. ReadFromJsonAsync<Comanda>() citește corpul JSON al cererii (cu numele proprietăților potrivite fără să conteze majusculele).
Alte forme ale mesajului
error CS4033: The 'await' operator can only be used within an async method. Consider marking this method with the 'async' modifier and changing its return type to 'Task'.error CS4032: The 'await' operator can only be used within an async method. Consider marking this method with the 'async' modifier and changing its return type to 'Task<IResult>'.
Cum o eviți pe viitor
- Când scrii
awaitîntr-un handler, verifică imediat că lambda începe cuasync. - Nu „repara” cu
.Resultsau.Wait(): în ASP.NET Core blochezi fire de execuție. - Pentru metode handler, tipul de retur devine
Task<IResult>sauTask<Results<...>>. - Activează analizoarele (de exemplu cele din
Microsoft.VisualStudio.Threading.Analyzers) care semnalează apelurile blocante.
Întrebări frecvente
Trebuie să scriu await dacă doar întorc ToListAsync()?
Nu neapărat: (MagazinDb db) => db.Produse.ToListAsync() întoarce un Task<List<Produs>>, iar ASP.NET Core îl așteaptă. Cu async/await codul e mai clar când ai mai mulți pași și excepțiile apar în locul firesc.
De ce e rău .Result într-un handler?
Blochează firul curent până termină operația. Sub încărcare, firele din pool se termină, cererile stau la coadă și aplicația pare blocată (thread pool starvation).
Erori înrudite
error CS1662: Cannot convert lambda expression to intended delegate type because some of the return types in the block are not implicitly convertible to the delegate return type Handler-ul întoarce tipuri diferite pe ramuri diferite (de exemplu un obiect și Results.NotFound()), iar compilatorul nu poate alege un singur tip de retur pentru lambda. Întoarce același tip peste tot: Results.Ok(obiect) și Results.NotFound(), ambele IResult. error CS1503: Argument 3: cannot convert from 'method group' to 'System.Delegate' Ai dat lui MapGet numele unei metode care are mai multe supraîncărcări, iar compilatorul nu știe pe care s-o aleagă, pentru că parametrul e un Delegate generic. Redenumește metodele sau învelește apelul într-o lambda. 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. Î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.
