...
Eroare ASP.NET Core · Compilare și pornirea aplicației

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.

Pe scurt

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

Greșit
C#
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapControllers();
app.Run();
Corect
C#
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()

Greșit
C#
var app = builder.Build();
builder.Services.AddControllers();
app.MapControllers();
Corect
C#
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ă tu

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.

Codul care dă eroarea
C#
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")];
}
După reparație, programul afișează
GET /api/clienti → 200 OK
[{"id":1,"nume":"Ana"},{"id":2,"nume":"Mihai"}]
Indiciu

Serviciile MVC se înregistrează pe builder.Services, înainte de Build().

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ă perechea builder.Services.AddX(): MapControllers cu AddControllers, UseAuthorization cu AddAuthorization, MapHealthChecks cu AddHealthChecks.
  • Ț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

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