404 Not Found la un controller (lipsește app.MapControllers())
Controllerul compilează și AddControllers() e prezent, dar fără app.MapControllers() rutele din atributele [Route] și [HttpGet] nu sunt create, deci orice cerere către controller primește 404. Adaugă app.MapControllers(); după Build().
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Lucrul cu controllere are doi pași separați. builder.Services.AddControllers() înregistrează serviciile MVC și descoperă clasele controller. app.MapControllers() transformă atributele de rutare ([Route("api/produse")], [HttpGet("{id:int}")]) în endpoint-uri. Fără al doilea pas aplicația pornește fără erori, dar nu are nicio rută de controller, iar fiecare cerere primește 404.
Alte cauze înrudite: clasa nu e publică sau e abstractă (nu e considerată controller), lipsește [Route] pe clasă și pe acțiune (cu [ApiController] primești chiar o eroare la pornire), sau ruta folosește [controller] și numele clasei nu se termină în Controller așa cum crezi (ProduseController dă api/Produse). În proiectele mai vechi, echivalentul era app.UseEndpoints(e => e.MapControllers()).
De ce apare: cauzele frecvente
1Lipsește MapControllers()
builder.Services.AddControllers();
var app = builder.Build();
app.Run();builder.Services.AddControllers();
var app = builder.Build();
app.MapControllers();
app.Run();MapControllers creează endpoint-urile din atributele controllerelor.
2Controllerul nu e public
[ApiController]
[Route("api/produse")]
class ProduseController : ControllerBase { }[ApiController]
[Route("api/produse")]
public class ProduseController : ControllerBase { }Doar clasele publice, neabstracte, sunt descoperite ca controllere.
3Ruta [controller] diferită de cea cerută
[Route("api/[controller]")]
public class ProdusController : ControllerBase { }
// clientul cere /api/produse[Route("api/produse")]
public class ProdusController : ControllerBase { }[controller] se înlocuiește cu numele clasei fără sufixul Controller, adică Produs.
Repară eroarea, direct în pagină
Controllerul ProduseController compilează și aplicația pornește, dar GET /api/produse răspunde 404 Not Found. Repară Program.cs ca cererea să întoarcă lista de produse din controller. Nu modifica clasa controllerului.
using Microsoft.AspNetCore.Mvc;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers();
var app = builder.Build();
app.Run();
public record Produs(int Id, string Nume);
[ApiController]
[Route("api/produse")]
public class ProduseController : ControllerBase
{
[HttpGet]
public List<Produs> GetAll() => [new(1, "Laptop"), new(2, "Mouse")];
}GET /api/produse → 200 OK
[{"id":1,"nume":"Laptop"},{"id":2,"nume":"Mouse"}]Indiciu
Serviciile MVC sunt înregistrate, dar rutele controllerelor trebuie și ele adăugate în aplicație.
Reparația
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
{
[HttpGet]
public List<Produs> GetAll() => [new(1, "Laptop"), new(2, "Mouse")];
}De ce merge
AddControllers() doar înregistrează serviciile; endpoint-urile pentru acțiunile controllerelor sunt create de app.MapControllers(), apelat după Build() și înainte de Run(). Fără el, ruta api/produse nu exista, deci rutarea dădea 404. După adăugare, atributele [Route] și [HttpGet] devin endpoint-ul GET /api/produse. Clasa controllerului nu trebuia schimbată.
Alte forme ale mesajului
404 Not Found la GET /api/produse (controller nedescoperit)
Cum o eviți pe viitor
- Pentru controllere, verifică perechea:
AddControllers()înainte deBuild(),MapControllers()după. - Declară controllerele
publicși moșteneșteControllerBase. - Preferă rute explicite (
[Route("api/produse")]) dacă numele clasei nu corespunde exact URL-ului dorit. - Scrie un test de integrare care cere cel puțin o rută din fiecare controller.
Întrebări frecvente
Pot amesteca controllere și Minimal APIs?
Da. MapControllers() și MapGet(...) coexistă în aceeași aplicație; ambele creează endpoint-uri în același sistem de rutare.
De ce nu primesc nicio eroare la pornire?
Pentru că, din punctul de vedere al aplicației, totul e valid: serviciile există, doar că nu ai cerut nicăieri crearea rutelor. Rezultatul e doar lipsa endpoint-urilor.
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. 404 Not Found (nicio rută nu se potrivește cu calea cererii) ASP.NET Core nu a găsit niciun endpoint pentru calea cererii, așa că răspunde 404 fără corp. Compară caracter cu caracter calea cerută cu rutele din MapGet / MapGroup / [Route]: o literă în plus, un prefix uitat sau un singular în loc de plural sunt cele mai dese cauze. error CS0246: The type or namespace name 'ControllerBase' could not be found (are you missing a using directive or an assembly reference?) Clasa ControllerBase și atributele [ApiController], [Route], [HttpGet] sunt în namespace-ul Microsoft.AspNetCore.Mvc, care nu e importat implicit în Program.cs. Adaugă using Microsoft.AspNetCore.Mvc; sus în fișierul controllerului. Î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.
