Jak usunąć zależność cykliczną w .NET?

Bruno Krawczyk • 15 listopada 2026
Ludzie analizują schemat blokowy na ekranie laptopa, który pokazuje złożone powiązania, przypominające **circular dependency**.

Spis treści

W projekcie ASP.NET Core dodajesz rejestrację nowej usługi, a aplikacja przestaje startować, bo `OrderService` potrzebuje `InvoiceService`, który z kolei potrzebuje `OrderService`. Zależność cykliczna zwykle oznacza, że odpowiedzialności klas lub modułów ułożyły się w zamknięty łańcuch, choć przyczyna może leżeć także w konfiguracji kontenera DI.

Diagram przedstawia zależności: Build

Przerwij cykl w miejscu, gdzie spotykają się dwie odpowiedzialności

  • Cykl w konstruktorach blokuje tworzenie usług przez kontener DI.
  • Cykl w referencjach projektów oznacza problem z kierunkiem zależności całych modułów.
  • Wspólna abstrakcja albo osobna usługa orkiestrująca często pozwala rozdzielić obowiązki.
  • Walidacja przy starcie pomaga wykryć część problemów wcześniej, ale nie zastępuje analizy architektury.

Najpierw ustal, czy pętla jest w usługach, czy w projektach

Na diagramie obie sytuacje wyglądają podobnie: strzałki wracają do punktu wyjścia. Problem pojawia się jednak na innym poziomie, więc samo przeniesienie interfejsu do nowego pliku może nie wystarczyć.

W pierwszym wariancie `OrderService` i `InvoiceService` wstrzykują się nawzajem, na przykład przez konstruktory. W drugim projekt `Orders` odwołuje się do `Billing`, a `Billing` do `Orders`. Pierwszy cykl dotyczy obiektów tworzonych przez kontener DI, drugi zależności kompilacyjnych między projektami.

Sytuacja Prawdopodobna przyczyna lub skutek Co zrobić
Wyjątek podczas rozwiązywania `OrderService` Usługi zależą od siebie bezpośrednio lub przez kolejne serwisy Przejdź po konstruktorach i zapisz pełny łańcuch zależności
Błąd kompilacji albo komunikat MSB4006 Cykl w grafie celów kompilacji lub konfiguracji MSBuild Sprawdź referencje projektów i zależności celów, zamiast zmieniać rejestrację DI
Oba projekty zawierają typy potrzebne drugiej stronie Granice modułów przecinają się w miejscu współdzielonego kontraktu Przenieś kontrakt do stabilnego modułu albo zmień podział odpowiedzialności

Dokumentacja Microsoft Learn opisuje MSB4006 jako cykl w grafie zależności celów kompilacji, więc ten komunikat nie dowodzi sam w sobie, że błąd leży w kontenerze DI. Najpierw rozpoznaj rodzaj grafu, a dopiero potem wybieraj naprawę.

Wspólna usługa często ujawnia, że dwie klasy robią za dużo

Wyobraź sobie, że `OrderService` zapisuje zamówienie, a potem prosi `InvoiceService` o wystawienie faktury. `InvoiceService` sprawdza z kolei status zamówienia, wywołując `OrderService`. Obie klasy znają cały proces i obie próbują nim sterować.

W takim układzie zwykle lepiej wydzielić orkiestrację do `CheckoutWorkflow`, który wywoła obie usługi w określonej kolejności. `OrderService` może wtedy odpowiadać za zamówienie, `InvoiceService` za fakturę, a workflow za przebieg przypadku użycia. Cykl znika, bo każda klasa przestaje odgrywać rolę pośrednika i koordynatora naraz.

Jeśli wspólny fragment to niewielki kontrakt, na przykład `IOrderStatusReader`, można umieścić go w module aplikacyjnym, a implementację pozostawić po stronie infrastruktury. Kierunek zależności prowadzi wtedy do abstrakcji; nie trzeba tworzyć projektu „Common” na każdy współdzielony typ, bo taki projekt szybko staje się kolejnym workiem przypadkowych zależności.

Uważam, że osobna usługa koordynująca jest dobrym wyborem wtedy, gdy obie strony próbują sterować tym samym procesem. Jeśli chodzi wyłącznie o jedną prostą informację, wydzielanie całego workflow byłoby nadmiarowe; wystarczy węższy kontrakt.

Jeśli cykl przechodzi przez trzy moduły, nie naprawiaj tylko ostatniej strzałki

Pośredni cykl potrafi ukryć się za kilkoma warstwami: `Orders` korzysta z `Customers`, `Customers` z `Notifications`, a `Notifications` z `Orders`. Wtedy zmiana jednego konstruktora może jedynie przesunąć problem, bo moduły nadal zależą od siebie w obu kierunkach.

Stosuję prostą regułę: jeśli zależność wraca przez warstwę infrastruktury lub projekt o innej odpowiedzialności, najpierw zmień granicę modułu albo kierunek kontraktu. Jeśli pętla wynika tylko z dwóch usług obsługujących jeden przypadek użycia, rozważ ich rozdzielenie i dodanie koordynatora. Przykładowo `Orders → Customers → Notifications → Orders` sugeruje, że `Notifications` nie powinien odpytywać `Orders` o stan w trakcie wysyłki; potrzebuje zdarzenia lub danych przekazanych przez koordynator.

Nie każda pętla na diagramie oznacza błąd wykonania. W modelu domenowym obiekty mogą mieć relacje dwukierunkowe, na przykład zamówienie i pozycje zamówienia. Problem zaczyna się wtedy, gdy te relacje przekładają się na wzajemne zależności modułów lub wymagają, by dwa serwisy tworzyły się nawzajem.

Walidacja DI wykrywa część błędów, ale nie ocenia podziału systemu

W .NET można włączyć `ValidateOnBuild`, by kontener sprawdził podczas budowania, czy zarejestrowane usługi da się utworzyć. To ułatwia wykrycie niektórych błędów rejestracji i cykli konstruktorów przed obsłużeniem pierwszego żądania; otwarte typy generyczne nie są jednak objęte tą walidacją.

W projekcie możesz ustawić tę opcję w konfiguracji hosta, na przykład w środowisku deweloperskim. Osobno sprawdź `ValidateScopes`, jeśli chcesz wykrywać nieprawidłowe użycie zakresów usług, takie jak pobranie usługi `Scoped` z kontenera głównego. Te ustawienia rozwiązują różne problemy, więc nie należy traktować ich zamiennie.

Walidator nie stwierdzi, czy `OrderService` i `InvoiceService` mają sensownie podzielone obowiązki. Do utrzymania kierunku zależności między projektami przydatne są diagramy zależności Visual Studio, które pozwalają opisać oczekiwane warstwy i wykrywać naruszenia. Kontener pilnuje tworzenia obiektów, a reguły architektury pilnują granic modułów.

Po usunięciu pętli sprawdź, czy nie została ukryta

Najłatwiejsza droga na skróty to `IServiceProvider` pobierany wewnątrz metody albo właściwość ustawiana po utworzeniu obiektu. Aplikacja może wtedy wystartować, lecz zależność nadal istnieje, tylko przestała być widoczna w konstruktorze. Taki zabieg utrudnia testowanie i sprawia, że kontrakt klasy nie pokazuje już wszystkich potrzeb.

Po zmianie przejrzyj referencje projektów, konstrukcje usług oraz przepływ wywołań w problematycznym przypadku użycia. Jeśli strzałka nadal wraca do modułu, od którego proces wyszedł, cykl najpewniej tylko zmienił formę. Dobra naprawa zostawia czytelną drogę od inicjatora operacji do jej wykonawców, bez wzajemnego tworzenia się usług.

FAQ - Najczęstsze pytania

Wyjątek podczas tworzenia usługi, na przykład OrderService, wskazuje na zależności konstruktorów, bezpośrednie lub przechodzące przez inne serwisy. Błąd kompilacji albo komunikat MSB4006 dotyczy grafu celów kompilacji lub konfiguracji MSBuild. Sprawdź więc, który graf tworzy pętlę, zanim zmienisz rejestrację DI.

Jeśli dwie usługi próbują sterować tym samym procesem, wydziel koordynację do osobnej usługi, takiej jak CheckoutWorkflow, która wywołuje je w odpowiedniej kolejności. Gdy druga usługa potrzebuje tylko jednej informacji, na przykład statusu zamówienia, wystarczy węższy kontrakt, taki jak IOrderStatusReader.

Prześledź pełny łańcuch, na przykład Orders → Customers → Notifications → Orders, i sprawdź, gdzie wraca zależność. Jeśli Notifications potrzebuje stanu zamówienia, może otrzymać dane od koordynatora albo zareagować na zdarzenie. Zmiana granicy modułu lub kierunku kontraktu rozwiązuje problem u źródła, zamiast tylko przesuwać pętlę.

ValidateOnBuild sprawdza podczas budowania, czy zarejestrowane usługi można utworzyć, i może wykryć część cykli konstruktorów; nie obejmuje jednak otwartych typów generycznych. ValidateScopes pomaga wykryć nieprawidłowe użycie zakresów, na przykład pobieranie usługi Scoped z kontenera głównego. Żadna z tych opcji nie ocenia, czy podział odpowiedzialności między modułami jest sensowny.

Oceń artykuł

Ocena: 0.00 Liczba głosów: 0

Tagi

msbuild
orkiestracja
kontener di
zależności cykliczne
Autor Bruno Krawczyk
Bruno Krawczyk
Mam na imię Bruno i od 8 lat zgłębiam tajniki programowania w ekosystemie .NET, chmury Azure oraz sztucznej inteligencji. Moja przygoda z technologią zaczęła się od ciekawości, jak złożone systemy mogą ułatwiać codzienne życie i rozwiązywać realne problemy. Dziś moją misją jest dzielenie się tą wiedzą, starając się przybliżyć nawet najbardziej skomplikowane zagadnienia w sposób zrozumiały i przystępny dla każdego. W moich artykułach na kursdotnet.pl skupiam się na praktycznych aspektach, analizuję najnowsze trendy i weryfikuję informacje, aby dostarczyć Wam treści, które są nie tylko dokładne i aktualne, ale przede wszystkim użyteczne w Waszej własnej ścieżce rozwoju technologicznego.

Udostępnij artykuł

Napisz komentarz