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.
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
class MiddlewareAudit(RequestDelegate next)
{
public Task Proceseaza(HttpContext ctx) => next(ctx);
}class MiddlewareAudit(RequestDelegate next)
{
public Task InvokeAsync(HttpContext ctx) => next(ctx);
}Convenția recunoaște doar numele Invoke și InvokeAsync.
2Metoda nu e publică
class MiddlewareAudit(RequestDelegate next)
{
private Task InvokeAsync(HttpContext ctx) => next(ctx);
}class MiddlewareAudit(RequestDelegate next)
{
public Task InvokeAsync(HttpContext ctx) => next(ctx);
}Reflection caută doar metode publice de instanță.
3Varianta cu interfață, verificată la compilare
class MiddlewareAudit
{
public Task Executa(HttpContext ctx, RequestDelegate next) => next(ctx);
}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ă 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.
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);
}
}Audit: GET /produse GET /produse → 200 OK ["Laptop","Mouse"]
Indiciu
Convenția caută Invoke sau InvokeAsync, publică, cu HttpContext ca prim parametru.
Reparația
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)
{
public async Task InvokeAsync(HttpContext ctx)
{
Console.WriteLine($"Audit: {ctx.Request.Method} {ctx.Request.Path}");
await next(ctx);
}
}De ce merge
UseMiddleware<T> nu folosește o interfață, ci caută prin reflection o metodă publică Invoke sau InvokeAsync. După redenumire, metoda e găsită, iar ASP.NET Core o cheamă la fiecare cerere cu HttpContext-ul ei. Restul middleware-ului (constructorul cu RequestDelegate, apelul next) era deja corect.
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ă
IMiddlewarecâ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
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. System.InvalidOperationException: No service for type 'ServiciuStoc' has been registered. Ai cerut explicit un serviciu cu GetRequiredService<T>() (sau [FromServices], [ServiceFilter], UseMiddleware cu IMiddleware), dar tipul nu este înregistrat în builder.Services. Adaugă înregistrarea (AddScoped, AddSingleton sau AddTransient) înainte de Build(). Î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.
