...
Eroare ASP.NET Core · Dependency injection și servicii

System.InvalidOperationException: A circular dependency was detected for the service of type 'ServiciuComenzi'. ServiciuComenzi -> ServiciuClienti -> ServiciuComenzi

Pe scurt

Două (sau mai multe) servicii se cer unul pe altul în constructor: ServiciuComenzi are nevoie de ServiciuClienti, iar acesta de ServiciuComenzi. Containerul nu poate crea niciunul primul. Rupe cercul: mută logica comună într-un al treilea serviciu sau elimină una dintre dependențe.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Containerul creează serviciile pornind de la constructori. Ca să creeze ServiciuComenzi, trebuie întâi ServiciuClienti; ca să-l creeze pe acesta, trebuie ServiciuComenzi, și tot așa la nesfârșit. Mesajul îți arată lanțul complet după nume: ServiciuComenzi -> ServiciuClienti -> ServiciuComenzi.

În Development eroarea apare la pornire, în „Some services are not able to be constructed”, câte o dată pentru fiecare serviciu din cerc. Cercul poate fi și mai lung (A → B → C → A), de obicei după ce un serviciu primește „încă o dependență” ca să refolosească o metodă.

Nu e o problemă a containerului, ci de design: două clase care depind una de alta sunt de fapt prea legate. Soluția este să extragi partea comună într-o clasă nouă, de care depind amândouă.

De ce apare: cauzele frecvente

1Două servicii își folosesc reciproc metodele

Greșit
C#
class ServiciuComenzi(ServiciuClienti clienti) { }
class ServiciuClienti(ServiciuComenzi comenzi)
{
    public int NumarComenzi(int id) => comenzi.PentruClient(id).Count;
}
Corect
C#
class RepositoryComenzi { public List<Comanda> PentruClient(int id) => []; }
class ServiciuComenzi(ServiciuClienti clienti, RepositoryComenzi repo) { }
class ServiciuClienti(RepositoryComenzi repo)
{
    public int NumarComenzi(int id) => repo.PentruClient(id).Count;
}

Partea de care aveau nevoie amândouă (citirea comenzilor) stă acum într-un serviciu separat. Graful de dependențe devine un arbore, fără cerc.

2Cerc ascuns prin trei servicii

Greșit
C#
class A(B b) { }
class B(C c) { }
class C(A a) { }
Corect
C#
class A(B b) { }
class B(C c) { }
class C(Evenimente ev) { }  // C anunță printr-un serviciu de evenimente, nu îl cheamă direct pe A

Un cerc lung se rupe la fel: una dintre legături devine o dependență spre un serviciu neutru (evenimente, notificări, repository).

Repară tu

Repară eroarea, direct în pagină

Aplicația nu pornește: ServiciuComenzi și ServiciuClienti se cer unul pe altul. Extrage lista comenzilor într-un RepositoryComenzi (scoped), folosit de amândouă, ca GET /clienti/1 să răspundă Ana are 2 comenzi.

Codul care dă eroarea
C#
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddScoped<ServiciuComenzi>();
builder.Services.AddScoped<ServiciuClienti>();
var app = builder.Build();

app.MapGet("/clienti/{id:int}", (int id, ServiciuClienti clienti) => clienti.Rezumat(id));

app.Run();

public record Comanda(int Id, int ClientId, decimal Total);

public class ServiciuComenzi(ServiciuClienti clienti)
{
    public List<Comanda> Toate() => [new(1, 1, 120m), new(2, 1, 80m), new(3, 2, 45m)];
    public List<Comanda> PentruClient(int id) => Toate().Where(c => c.ClientId == id).ToList();
}

// TODO: ServiciuClienti nu trebuie să depindă de ServiciuComenzi
public class ServiciuClienti(ServiciuComenzi comenzi)
{
    public string Rezumat(int id) => $"Ana are {comenzi.PentruClient(id).Count} comenzi";
}
După reparație, programul afișează
GET /clienti/1 → 200 OK
Ana are 2 comenzi
Indiciu

ServiciuClienti nu mai cere ServiciuComenzi, ci RepositoryComenzi.

Alte forme ale mesajului

  • A circular dependency was detected for the service of type 'ServiciuClienti'. ServiciuClienti -> ServiciuComenzi -> ServiciuClienti

Cum o eviți pe viitor

  • Păstrează dependențele într-o singură direcție: controller → serviciu → repository, nu și invers.
  • Când un serviciu are nevoie de „o metodă” din alt serviciu de același nivel, extrage metoda într-o clasă comună.
  • Constructorii cu multe dependențe sunt un semnal că serviciul face prea multe.
  • Nu rezolva cercul cu IServiceProvider sau Lazy<T> decât ca soluție temporară: problema de design rămâne.

Întrebări frecvente

Pot folosi Lazy<T> ca să rup cercul?

Containerul implicit nu oferă Lazy<T> automat, iar soluțiile de tip „rezolv mai târziu din IServiceProvider” doar ascund cuplarea. Extrage partea comună într-un serviciu nou.

De ce mesajul apare de două ori?

Validarea verifică fiecare serviciu înregistrat. Ambele servicii din cerc dau eroarea, fiecare cu lanțul pornind de la el.

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.