System.InvalidOperationException: Action 'ProduseController.Lista (Magazin)' does not have an attribute route. Action methods on controllers annotated with ApiControllerAttribute must be attribute routed.
Un controller cu [ApiController] are o acțiune publică fără rută de atribut ([Route] pe controller sau [HttpGet("...")] pe metodă). Pentru API-uri, rutarea convențională nu e permisă. Pune [Route("api/[controller]")] pe clasă și [HttpGet]/[HttpPost] pe acțiuni; metodele care nu sunt acțiuni primesc [NonAction] sau devin private.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
[ApiController] impune rutarea prin atribute: fiecare acțiune trebuie să aibă o rută dată prin [Route] (pe controller sau pe metodă) sau prin [HttpGet("...")], [HttpPost] etc. combinate cu un [Route] pe clasă. Dacă o metodă publică a controllerului nu are nicio rută, aplicația nu pornește: la MapControllers(), MVC aruncă această excepție și îți spune exact acțiunea (ProduseController.Lista).
Cauzele tipice: ai uitat [Route("api/produse")] pe clasă; ai adăugat o metodă publică ajutătoare (CalculeazaTotal) în controller, pe care MVC o consideră acțiune; ai copiat un controller MVC clasic, care folosea rutarea convențională ({controller}/{action}/{id?}).
Orice metodă publică dintr-un controller e acțiune, dacă nu are [NonAction].
De ce apare: cauzele frecvente
1Lipsește [Route] pe controller
[ApiController]
public class ProduseController : ControllerBase
{
[HttpGet]
public IActionResult Lista() => Ok();
}[ApiController]
[Route("api/produse")]
public class ProduseController : ControllerBase
{
[HttpGet]
public IActionResult Lista() => Ok();
}[HttpGet] fără șablon se combină cu ruta controllerului; fără ea, acțiunea nu are rută.
2Metodă ajutătoare publică
public decimal CalculeazaTotal(List<decimal> preturi) => preturi.Sum();private decimal CalculeazaTotal(List<decimal> preturi) => preturi.Sum();
// sau: [NonAction] public decimal CalculeazaTotal(...)Metodele publice din controller sunt acțiuni. Ajutătoarele se fac private sau primesc [NonAction].
Repară eroarea, direct în pagină
Aplicația nu pornește: ProduseController are [ApiController], dar nu are rută. Adaugă ruta api/produse pe controller și fă privată metoda ajutătoare Formateaza, ca GET /api/produse să răspundă cu lista formatată.
using System.ComponentModel.DataAnnotations;
using Microsoft.AspNetCore.Mvc;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers();
var app = builder.Build();
app.MapControllers();
app.Run();
[ApiController]
// TODO: ruta controllerului
public class ProduseController : ControllerBase
{
[HttpGet]
public IActionResult Lista() => Ok(new[] { Formateaza("Laptop", 3500m), Formateaza("Mouse", 99m) });
// TODO: metoda ajutătoare nu e o acțiune
public string Formateaza(string nume, decimal pret) => $"{nume} - {pret} lei";
}GET /api/produse → 200 OK ["Laptop - 3500 lei","Mouse - 99 lei"]
Indiciu
[Route("api/produse")] pe clasă; o metodă publică fără rută e tot o acțiune.
Reparația
using System.ComponentModel.DataAnnotations;
using Microsoft.AspNetCore.Mvc;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers();
var app = builder.Build();
app.MapControllers();
app.Run();
[ApiController]
[Route("api/produse")]
public class ProduseController : ControllerBase
{
[HttpGet]
public IActionResult Lista() => Ok(new[] { Formateaza("Laptop", 3500m), Formateaza("Mouse", 99m) });
private string Formateaza(string nume, decimal pret) => $"{nume} - {pret} lei";
}De ce merge
[ApiController] cere ca toate acțiunile să aibă rute prin atribute. [Route("api/produse")] pe clasă, combinat cu [HttpGet], dă ruta acțiunii Lista. Metoda Formateaza era publică, deci MVC o trata ca acțiune fără rută; privată, nu mai este considerată endpoint. Aplicația pornește și ruta e cea așteptată.
Alte forme ale mesajului
System.InvalidOperationException: Action methods on controllers annotated with ApiControllerAttribute must be attribute routed.
Cum o eviți pe viitor
- Pune
[Route("api/[controller]")](sau ruta explicită) pe fiecare controller API. - Ține logica ajutătoare în servicii, nu în metode publice ale controllerului.
- Folosește
[NonAction]pentru metodele publice care nu sunt endpoint-uri. - Rulează aplicația după ce adaugi un controller nou: eroarea apare la pornire, deci o prinzi imediat.
Întrebări frecvente
Ce înseamnă [controller] în rută?
E un token înlocuit cu numele clasei fără sufixul Controller: ProduseController devine Produse, deci ruta api/[controller] devine api/Produse.
De ce aplicația nu pornește deloc, nu doar acțiunea respectivă?
MVC construiește tabela de rute pentru toate controllerele la pornire. O acțiune invalidă face întreaga configurare invalidă.
Erori înrudite
System.InvalidOperationException: Unable to find the required services. Please add all the required services by calling 'IServiceCollection.AddControllers' inside the call to 'ConfigureServices(...)' in the application startup code. Ai apelat app.MapControllers() fără să înregistrezi serviciile MVC. Adaugă builder.Services.AddControllers(); înainte de builder.Build(). Mesajul vorbește de ConfigureServices pentru că a fost scris pe vremea clasei Startup. System.InvalidOperationException: No route matches the supplied values. CreatedAtAction sau CreatedAtRoute nu a găsit acțiunea/ruta indicată cu valorile date, deci nu poate construi antetul Location. Cauza clasică: acțiunea se numește GetByIdAsync, dar MVC elimină sufixul Async, deci nameof(GetByIdAsync) nu mai corespunde. Folosește numele fără Async sau dezactivează eliminarea sufixului. Î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.
