...
Eroare ASP.NET Core · Middleware, pipeline și excepții

System.InvalidOperationException: The 'Invoke' or 'InvokeAsync' method's first argument must be of type 'HttpContext'.

Pe scurt

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

Greșit
C#
public async Task InvokeAsync(ContorCereri contor, HttpContext ctx)
{
    contor.Creste();
    await next(ctx);
}
Corect
C#
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

Greșit
C#
public Task InvokeAsync(ILogger<MiddlewareTimp> log) { ... }
Corect
C#
public Task InvokeAsync(HttpContext ctx, ILogger<MiddlewareTimp> log) { ... }

Fără context, middleware-ul nu are cererea pe care s-o proceseze.

Repară tu

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

Codul care dă eroarea
C#
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);
    }
}
După reparație, programul afișează
Cererea 1
GET / → 200 OK
OK
Cererea 2
GET / → 200 OK
OK
Indiciu

HttpContext trebuie să fie primul parametru.

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

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