...
Eroare ASP.NET Core · Controllere, validare și ProblemDetails

System.InvalidOperationException: No route matches the supplied values.

Pe scurt

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

Greșit
C#
[HttpGet("{id:int}")]
public async Task<ActionResult<Produs>> GetByIdAsync(int id) => ...

return CreatedAtAction(nameof(GetByIdAsync), new { id = p.Id }, p);
Corect
C#
[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

Greșit
C#
[HttpGet("{id:int}")] public IActionResult GetById(int id) => ...
return CreatedAtAction(nameof(GetById), new { produsId = p.Id }, p);
Corect
C#
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

Greșit
C#
builder.Services.AddControllers();
Corect
C#
builder.Services.AddControllers(o => o.SuppressAsyncSuffixInActionNames = false);

Cu opțiunea dezactivată, acțiunea rămâne înregistrată ca GetByIdAsync, deci nameof(GetByIdAsync) merge.

Repară tu

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.

Codul care dă eroarea
C#
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);
    }
}
După reparație, programul afișează
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.

Cum o eviți pe viitor

  • Nu pune sufixul Async pe numele acțiunilor din controllere (sau dezactivează opțiunea global).
  • Folosește întotdeauna nameof, nu text.
  • Scrie un test care verifică antetul Location după 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

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