System.InvalidOperationException: The 'Invoke' or 'InvokeAsync' method's first argument must be of type 'HttpContext'.
Metoda Invoke/InvokeAsync a middleware-ului bazat pe convenție are ca prim parametru altceva decât HttpContext (de exemplu un serviciu). Mută HttpContext pe prima poziție; serviciile scoped pot veni după el.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Convenția pentru middleware cere ca metoda Invoke/InvokeAsync să primească întâi HttpContext. Parametrii de după el sunt rezolvați din containerul de DI, pentru fiecare cerere (așa primești servicii scoped într-un middleware). Dacă primul parametru e alt tip, de exemplu ILogger<T> sau AppDb, ASP.NET Core nu poate apela metoda și oprește pornirea cu acest mesaj.
Greșeala apare tipic când adaugi un serviciu în semnătură și îl pui primul, din obișnuință, sau când copiezi semnătura de la IMiddleware (InvokeAsync(HttpContext, RequestDelegate)) într-o clasă bazată pe convenție, cu parametrii inversați.
De ce apare: cauzele frecvente
1Serviciul e pus înaintea contextului
public async Task InvokeAsync(ContorCereri contor, HttpContext ctx)
{
contor.Creste();
await next(ctx);
}public async Task InvokeAsync(HttpContext ctx, ContorCereri contor)
{
contor.Creste();
await next(ctx);
}Primul parametru e mereu HttpContext; serviciile vin după el și sunt injectate la fiecare cerere.
2Lipsește complet HttpContext
public Task InvokeAsync(ILogger<MiddlewareTimp> log) { ... }public Task InvokeAsync(HttpContext ctx, ILogger<MiddlewareTimp> log) { ... }Fără context, middleware-ul nu are cererea pe care s-o proceseze.
Repară eroarea, direct în pagină
Aplicația nu pornește: MiddlewareContor.InvokeAsync primește întâi serviciul ContorCereri, apoi HttpContext. Inversează parametrii, ca fiecare cerere să scrie în consolă numărul ei (Cererea 1, Cererea 2).
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddSingleton<ContorCereri>();
var app = builder.Build();
app.UseMiddleware<MiddlewareContor>();
app.MapGet("/", () => "OK");
app.Run();
public class ContorCereri
{
public int Total { get; private set; }
public int Creste() => ++Total;
}
public class MiddlewareContor(RequestDelegate next)
{
// TODO: ordinea parametrilor
public async Task InvokeAsync(ContorCereri contor, HttpContext ctx)
{
Console.WriteLine($"Cererea {contor.Creste()}");
await next(ctx);
}
}Cererea 1 GET / → 200 OK OK Cererea 2 GET / → 200 OK OK
Indiciu
HttpContext trebuie să fie primul parametru.
Reparația
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddSingleton<ContorCereri>();
var app = builder.Build();
app.UseMiddleware<MiddlewareContor>();
app.MapGet("/", () => "OK");
app.Run();
public class ContorCereri
{
public int Total { get; private set; }
public int Creste() => ++Total;
}
public class MiddlewareContor(RequestDelegate next)
{
public async Task InvokeAsync(HttpContext ctx, ContorCereri contor)
{
Console.WriteLine($"Cererea {contor.Creste()}");
await next(ctx);
}
}De ce merge
Convenția cere HttpContext pe prima poziție, iar parametrii următori sunt servicii injectate la fiecare cerere. După inversare, ASP.NET Core poate apela metoda, iar ContorCereri, fiind singleton, păstrează numărătoarea între cereri. Serviciile scoped ar fi injectate tot așa, pentru fiecare cerere.
Cum o eviți pe viitor
- Scrie semnătura după șablonul
InvokeAsync(HttpContext context, ServiciuA a, ServiciuB b). - Pentru verificare la compilare, folosește
IMiddleware. - Pune serviciile scoped în parametrii metodei, nu în constructor.
- Rulează aplicația după orice schimbare a semnăturii: eroarea apare la construirea pipeline-ului, înainte de prima cerere.
- Ține semnătura middleware-urilor la fel în tot proiectul, ca greșelile să sară în ochi la code review.
Întrebări frecvente
De ce serviciile scoped merg ca parametri, dar nu în constructor?
Middleware-ul bazat pe convenție e creat o singură dată (practic singleton). Constructorul ar primi serviciile o singură dată; parametrii metodei sunt rezolvați la fiecare cerere, din scope-ul ei.
Pot primi RequestDelegate ca parametru al lui InvokeAsync?
Nu, la convenție next vine în constructor. Doar la IMiddleware e parametru al metodei.
Erori înrudite
System.InvalidOperationException: No public 'Invoke' or 'InvokeAsync' method found for middleware of type 'MiddlewareAudit'. Clasa folosită cu app.UseMiddleware<T>() nu are o metodă publică numită Invoke sau InvokeAsync. Middleware-ul bazat pe convenție trebuie să aibă exact unul dintre aceste nume, să primească HttpContext ca prim parametru și să întoarcă Task. System.InvalidOperationException: Cannot resolve scoped service 'AppDb' from root provider. Ai cerut un serviciu scoped (de exemplu DbContext) direct din app.Services, adică din providerul rădăcină, unde nu există nicio cerere HTTP care să definească un scope. Creează un scope: using var scope = app.Services.CreateScope(); și ia serviciul din scope.ServiceProvider. Î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.
