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

System.InvalidOperationException: No public 'Invoke' or 'InvokeAsync' method found for middleware of type 'MiddlewareAudit'.

Pe scurt

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.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

app.UseMiddleware<MiddlewareAudit>() folosește convenția: nu există o interfață de implementat, ci ASP.NET Core caută prin reflection o metodă publică numită Invoke sau InvokeAsync. Dacă metoda are alt nume (Proceseaza, Execute, Handle), e privată sau lipsește, primești această eroare la construirea pipeline-ului, deci aplicația nu pornește.

Regulile convenției: constructor public cu RequestDelegate next (plus servicii singleton, dacă e nevoie); metodă publică Invoke/InvokeAsync care primește HttpContext ca prim parametru, eventual servicii scoped după el, și întoarce Task; o singură astfel de metodă.

Alternativa fără convenție este interfața IMiddleware, cu metoda InvokeAsync(HttpContext, RequestDelegate), verificată de compilator; clasa trebuie atunci înregistrată în DI.

De ce apare: cauzele frecvente

1Metoda are alt nume

Greșit
C#
class MiddlewareAudit(RequestDelegate next)
{
    public Task Proceseaza(HttpContext ctx) => next(ctx);
}
Corect
C#
class MiddlewareAudit(RequestDelegate next)
{
    public Task InvokeAsync(HttpContext ctx) => next(ctx);
}

Convenția recunoaște doar numele Invoke și InvokeAsync.

2Metoda nu e publică

Greșit
C#
class MiddlewareAudit(RequestDelegate next)
{
    private Task InvokeAsync(HttpContext ctx) => next(ctx);
}
Corect
C#
class MiddlewareAudit(RequestDelegate next)
{
    public Task InvokeAsync(HttpContext ctx) => next(ctx);
}

Reflection caută doar metode publice de instanță.

3Varianta cu interfață, verificată la compilare

Greșit
C#
class MiddlewareAudit
{
    public Task Executa(HttpContext ctx, RequestDelegate next) => next(ctx);
}
Corect
C#
class MiddlewareAudit : IMiddleware
{
    public Task InvokeAsync(HttpContext ctx, RequestDelegate next) => next(ctx);
}
// builder.Services.AddTransient<MiddlewareAudit>();

Cu IMiddleware, compilatorul te obligă să ai metoda corectă.

Repară tu

Repară eroarea, direct în pagină

Aplicația nu pornește: MiddlewareAudit are metoda Proceseaza, pe care convenția nu o recunoaște. Redenumește-o ca middleware-ul să fie găsit, astfel încât fiecare cerere să scrie în consolă Audit: GET /produse.

Codul care dă eroarea
C#
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.UseMiddleware<MiddlewareAudit>();

app.MapGet("/produse", () => new[] { "Laptop", "Mouse" });

app.Run();

public class MiddlewareAudit(RequestDelegate next)
{
    // TODO: numele metodei nu respectă convenția
    public async Task Proceseaza(HttpContext ctx)
    {
        Console.WriteLine($"Audit: {ctx.Request.Method} {ctx.Request.Path}");
        await next(ctx);
    }
}
După reparație, programul afișează
Audit: GET /produse
GET /produse → 200 OK
["Laptop","Mouse"]
Indiciu

Convenția caută Invoke sau InvokeAsync, publică, cu HttpContext ca prim parametru.

Alte forme ale mesajului

  • System.InvalidOperationException: Multiple public 'Invoke' or 'InvokeAsync' methods are available.
  • System.InvalidOperationException: The 'Invoke' or 'InvokeAsync' method's first argument must be of type 'HttpContext'.

Cum o eviți pe viitor

  • Pornește middleware-urile dintr-un șablon cu semnătura corectă.
  • Preferă IMiddleware când vrei verificare la compilare și servicii scoped în constructor.
  • Pentru logică simplă, app.Use(async (ctx, next) => ...) evită complet convenția.
  • Rulează aplicația imediat după ce adaugi un middleware nou: eroarea apare la pornire, deci o vezi înainte de orice cerere.

Întrebări frecvente

De ce ASP.NET Core folosește convenție și nu o interfață?

Ca metoda să poată primi servicii scoped ca parametri suplimentari (InvokeAsync(HttpContext ctx, AppDb db)), injectate la fiecare cerere. O interfață ar fixa semnătura.

Pot avea și Invoke, și InvokeAsync?

Nu. Dacă există ambele, primești „Multiple public 'Invoke' or 'InvokeAsync' methods are available.” Păstrează una singură.

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.