...
Eroare ASP.NET Core · Rutare: 404, 405 și rute ambigue

404 Not Found la un controller (lipsește app.MapControllers())

Pe scurt

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()

Greșit
C#
builder.Services.AddControllers();
var app = builder.Build();
app.Run();
Corect
C#
builder.Services.AddControllers();
var app = builder.Build();
app.MapControllers();
app.Run();

MapControllers creează endpoint-urile din atributele controllerelor.

2Controllerul nu e public

Greșit
C#
[ApiController]
[Route("api/produse")]
class ProduseController : ControllerBase { }
Corect
C#
[ApiController]
[Route("api/produse")]
public class ProduseController : ControllerBase { }

Doar clasele publice, neabstracte, sunt descoperite ca controllere.

3Ruta [controller] diferită de cea cerută

Greșit
C#
[Route("api/[controller]")]
public class ProdusController : ControllerBase { }
// clientul cere /api/produse
Corect
C#
[Route("api/produse")]
public class ProdusController : ControllerBase { }

[controller] se înlocuiește cu numele clasei fără sufixul Controller, adică Produs.

Repară tu

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.

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

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 de Build(), MapControllers() după.
  • Declară controllerele public și moștenește ControllerBase.
  • 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

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