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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Controllerele au nevoie de multe servicii interne: descoperirea controllerelor din assembly, model binding, validare, formatarea JSON, filtre. Toate sunt înregistrate de builder.Services.AddControllers(). app.MapControllers() creează endpoint-urile din atributele [Route] și [HttpGet], iar pentru asta caută acele servicii; dacă nu le găsește, aruncă excepția la pornire.
Textul pomenește ConfigureServices(...) și „application startup code” din motive istorice: în .NET Core 3.1 și .NET 5, serviciile se înregistrau în metoda Startup.ConfigureServices. În .NET 6+ cu WebApplication, echivalentul este zona dintre CreateBuilder și Build, unde scrii builder.Services.Add....
Aceeași familie de mesaje apare pentru AddAuthorization, AddRazorPages sau AddHealthChecks: middleware-ul sau endpoint-ul cere servicii pe care nu le-ai adăugat.
De ce apare: cauzele frecvente
1Lipsește AddControllers()
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapControllers();
app.Run();var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers();
var app = builder.Build();
app.MapControllers();
app.Run();AddControllers înregistrează serviciile MVC cerute de MapControllers.
2AddControllers() pus după Build()
var app = builder.Build();
builder.Services.AddControllers();
app.MapControllers();builder.Services.AddControllers();
var app = builder.Build();
app.MapControllers();Containerul se construiește la Build(). Ce adaugi după nu mai ajunge în el (în ASP.NET Core real primești o altă excepție, că lista e read-only).
Repară eroarea, direct în pagină
API-ul cu controllere se oprește la pornire cu Unable to find the required services. Please add all the required services by calling 'IServiceCollection.AddControllers'.... Repară Program.cs ca GET /api/clienti să întoarcă lista de clienți.
using Microsoft.AspNetCore.Mvc;
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapControllers();
app.Run();
public record Client(int Id, string Nume);
[ApiController]
[Route("api/clienti")]
public class ClientiController : ControllerBase
{
[HttpGet]
public List<Client> GetAll() => [new(1, "Ana"), new(2, "Mihai")];
}GET /api/clienti → 200 OK
[{"id":1,"nume":"Ana"},{"id":2,"nume":"Mihai"}]Indiciu
Serviciile MVC se înregistrează pe builder.Services, înainte de Build().
Reparația
using Microsoft.AspNetCore.Mvc;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers();
var app = builder.Build();
app.MapControllers();
app.Run();
public record Client(int Id, string Nume);
[ApiController]
[Route("api/clienti")]
public class ClientiController : ControllerBase
{
[HttpGet]
public List<Client> GetAll() => [new(1, "Ana"), new(2, "Mihai")];
}De ce merge
MapControllers() are nevoie de serviciile MVC (descoperirea controllerelor, binding, serializare JSON), înregistrate de builder.Services.AddControllers(). Apelul trebuie pus înainte de builder.Build(), pentru că acolo se construiește containerul. Cu serviciile prezente, MapControllers găsește ClientiController și creează ruta GET api/clienti. Același tipar se aplică la autorizare, Razor Pages și health checks.
Alte forme ale mesajului
System.InvalidOperationException: Unable to find the required services. Please add all the required services by calling 'IServiceCollection.AddAuthorization' in the application startup code.System.InvalidOperationException: Unable to find the required services. Please add all the required services by calling 'IServiceCollection.AddRazorPages' inside the call to 'ConfigureServices(...)' in the application startup code.
Cum o eviți pe viitor
- Pentru fiecare
app.MapX()/app.UseX()verifică perecheabuilder.Services.AddX():MapControllerscuAddControllers,UseAuthorizationcuAddAuthorization,MapHealthCheckscuAddHealthChecks. - Ține toate înregistrările grupate înainte de
builder.Build(). - Pornește aplicația local după orice schimbare în
Program.cs: eroarea apare imediat, la pornire.
Întrebări frecvente
Am AddMvc() în loc de AddControllers(). E o problemă?
Nu dă eroarea asta: AddMvc include serviciile pentru controllere, dar adaugă și Razor Pages și views. Pentru un API e suficient și mai ușor AddControllers().
Unde e ConfigureServices în .NET 8?
Nu mai există în șablonul implicit. Codul dintre WebApplication.CreateBuilder(args) și builder.Build() ține locul lui.
Erori înrudite
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. 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(). System.InvalidOperationException: Build can only be called once. builder.Build() a fost apelat de două ori pe același WebApplicationBuilder. Un builder produce o singură aplicație: păstrează un singur var app = builder.Build(); și folosește aceeași variabilă app peste tot. Î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.
