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

error CS4034: The 'await' operator can only be used within an async lambda expression. Consider marking this lambda expression with the 'async' modifier.

Pe scurt

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

Greșit
C#
app.MapGet("/produse", (MagazinDb db) => await db.Produse.ToListAsync());
Corect
C#
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

Greșit
C#
app.Use((context, next) =>
{
    context.Response.Headers["X-Magazin"] = "demo";
    await next(context);
});
Corect
C#
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ă tu

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.

Codul care dă eroarea
C#
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);
După reparație, programul afișează
POST /comenzi → 200 OK
Comandă primită: 3 x Mouse
Indiciu

Lambda care conține await trebuie marcată cu un modificator.

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 cu async.
  • Nu „repara” cu .Result sau .Wait(): în ASP.NET Core blochezi fire de execuție.
  • Pentru metode handler, tipul de retur devine Task<IResult> sau Task<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

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