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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
CreatedAtAction(nameof(GetById), new { id = 5 }, produs) construiește URL-ul acțiunii GetById cu id = 5 și îl pune în antetul Location al răspunsului 201. Dacă generatorul de link-uri nu găsește o acțiune cu acel nume, sau ruta ei cere valori pe care nu le-ai dat (de exemplu {id} lipsește din obiectul anonim, ori numele diferă: produsId față de id), aruncă No route matches the supplied values. și cererea se termină cu 500, deși datele au fost deja salvate.
Cea mai frecventă cauză: MVC elimină implicit sufixul Async din numele acțiunilor (SuppressAsyncSuffixInActionNames = true). Acțiunea GetByIdAsync e înregistrată ca GetById, iar nameof(GetByIdAsync) dă "GetByIdAsync", care nu există.
La CreatedAtRoute, verifică numele dat cu Name = "..." în atributul de rută.
De ce apare: cauzele frecvente
1Sufixul Async în nameof
[HttpGet("{id:int}")]
public async Task<ActionResult<Produs>> GetByIdAsync(int id) => ...
return CreatedAtAction(nameof(GetByIdAsync), new { id = p.Id }, p);[HttpGet("{id:int}")]
public async Task<ActionResult<Produs>> GetById(int id) => ...
return CreatedAtAction(nameof(GetById), new { id = p.Id }, p);Fără sufix în numele metodei, nameof dă exact numele sub care MVC a înregistrat acțiunea.
2Valoarea de rută are alt nume
[HttpGet("{id:int}")] public IActionResult GetById(int id) => ...
return CreatedAtAction(nameof(GetById), new { produsId = p.Id }, p);return CreatedAtAction(nameof(GetById), new { id = p.Id }, p);Proprietățile obiectului anonim trebuie să aibă numele parametrilor din șablonul rutei.
3Păstrezi Async în nume
builder.Services.AddControllers();builder.Services.AddControllers(o => o.SuppressAsyncSuffixInActionNames = false);Cu opțiunea dezactivată, acțiunea rămâne înregistrată ca GetByIdAsync, deci nameof(GetByIdAsync) merge.
Repară eroarea, direct în pagină
POST /api/produse salvează produsul, dar răspunde 500 cu No route matches the supplied values., pentru că acțiunea GetByIdAsync e înregistrată ca GetById. Redenumește acțiunea în GetById și folosește nameof(GetById), ca răspunsul să fie 201 cu Location.
using System.ComponentModel.DataAnnotations;
using Microsoft.AspNetCore.Mvc;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers();
var app = builder.Build();
app.MapControllers();
app.Run();
public record Produs(int Id, string Nume);
[ApiController]
[Route("api/produse")]
public class ProduseController : ControllerBase
{
private static readonly List<Produs> produse = [new(1, "Laptop"), new(2, "Mouse")];
// TODO: MVC elimină sufixul Async din numele acțiunii
[HttpGet("{id:int}")]
public Task<ActionResult<Produs>> GetByIdAsync(int id) =>
Task.FromResult<ActionResult<Produs>>(produse.FirstOrDefault(p => p.Id == id) is Produs p ? p : NotFound());
[HttpPost]
public IActionResult Adauga(Produs nou)
{
var produs = nou with { Id = produse.Max(p => p.Id) + 1 };
produse.Add(produs);
return CreatedAtAction(nameof(GetByIdAsync), new { id = produs.Id }, produs);
}
}POST /api/produse → 201 Created
Location: http://localhost/api/produse/3
{"id":3,"nume":"Monitor"}
GET /api/produse/3 → 200 OK
{"id":3,"nume":"Monitor"}Indiciu
MVC elimină sufixul Async din numele acțiunilor.
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();
public record Produs(int Id, string Nume);
[ApiController]
[Route("api/produse")]
public class ProduseController : ControllerBase
{
private static readonly List<Produs> produse = [new(1, "Laptop"), new(2, "Mouse")];
[HttpGet("{id:int}")]
public Task<ActionResult<Produs>> GetById(int id) =>
Task.FromResult<ActionResult<Produs>>(produse.FirstOrDefault(p => p.Id == id) is Produs p ? p : NotFound());
[HttpPost]
public IActionResult Adauga(Produs nou)
{
var produs = nou with { Id = produse.Max(p => p.Id) + 1 };
produse.Add(produs);
return CreatedAtAction(nameof(GetById), new { id = produs.Id }, produs);
}
}De ce merge
MVC a înregistrat acțiunea ca GetById, fără sufixul Async, iar nameof(GetByIdAsync) căuta un nume inexistent. După redenumire, CreatedAtAction(nameof(GetById), new { id = ... }, produs) găsește acțiunea, construiește http://localhost/api/produse/3 și îl pune în Location, cu statusul 201. Clientul primește și adresa noului produs.
Cum o eviți pe viitor
- Nu pune sufixul
Asyncpe numele acțiunilor din controllere (sau dezactivează opțiunea global). - Folosește întotdeauna
nameof, nu text. - Scrie un test care verifică antetul
Locationdupă un POST. - Salvează după ce ai verificat că poți construi răspunsul, sau tratează excepția, ca să nu întorci 500 după o salvare reușită.
Întrebări frecvente
De ce datele sunt salvate, deși răspunsul e 500?
Excepția apare la scrierea rezultatului, după ce acțiunea a terminat (și a salvat). Clientul primește 500 și poate reîncerca, creând un duplicat. De aceea bug-ul e periculos.
Apare și la CreatedAtRoute?
Da, cu același mesaj, când numele rutei (Name = "...") nu există sau lipsesc valori de rută.
Erori înrudite
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. {"type":"https://tools.ietf.org/html/rfc9110#section-15.5.5","title":"Not Found","status":404} Acțiunea a întors NotFound() fără mesaj, iar [ApiController] a transformat răspunsul gol într-un ProblemDetails standard: type cu link spre RFC 9110, title Not Found, status 404. Clientul nu află ce lipsește. Trimite un mesaj: NotFound(new { mesaj = ... }) sau Problem(detail: ..., statusCode: 404). Î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.
