...
Eroare Spring Boot · Aplicația nu pornește: bean-uri și injectare

BeanCurrentlyInCreationException: Error creating bean with name 'facturaService': Requested bean is currently in creation: Is there an unresolvable circular reference?

Pe scurt

Spring a ajuns din nou la un bean pe care încă îl crea, adică există un cerc de dependențe (de obicei prin constructori sau @Autowired). Găsește cercul și rupe-l, mutând logica comună într-o clasă separată.

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

Ce înseamnă

BeanCurrentlyInCreationException este forma din stiva de apeluri a dependenței circulare. Spring creează facturaService, care are nevoie de un alt bean; acela (direct sau prin alții) are nevoie înapoi de facturaService, care e încă „în curs de creare”. Spring nu are un obiect gata de dat, deci întreabă: Is there an unresolvable circular reference?.

În Spring Boot 2.6+ vezi de obicei blocul APPLICATION FAILED TO START cu desenul ciclului (┌─────┐), iar această excepție apare în log, mai jos, ca Caused by. În aplicațiile Spring fără Boot sau în teste apare direct.

Ciclul poate fi mascat: injectare în câmpuri, un @Bean care cere un bean care cere clasa de configurare, sau trei-patru clase legate în lanț. Urmărește numele din desen sau din mesajele Error creating bean with name succesive.

De ce apare: cauzele frecvente

1Ciclu prin câmpuri @Autowired

Greșit
JAVA
@Service class FacturaService { @Autowired ClientService c; }
@Service class ClientService { @Autowired FacturaService f; }
Corect
JAVA
@Service class FacturaService { @Autowired ClientService c; }
@Service class ClientService { } // nu mai cere FacturaService

Chiar și cu câmpuri, Boot 2.6+ refuză ciclul. Elimină direcția care nu e necesară.

2Ciclu prin trei clase

Greșit
JAVA
FacturaService -> TvaService -> ClientService -> FacturaService
Corect
JAVA
FacturaService -> TvaService
ClientService  -> TvaService

Dacă toți aveau nevoie de calculul TVA, TvaService trebuie să fie dependența comună, fără să ceară la rândul lui pe cineva din cerc.

Repară tu

Repară eroarea, direct în pagină

Trei servicii formează un cerc: FacturaService → TvaService → ClientService → FacturaService. Aplicația nu pornește. Rupe cercul: ClientService nu are nevoie de FacturaService (îi trebuie doar o valoare fixă de prefix). Ruta GET /facturi/total?suma=100 trebuie să răspundă FCT-Ana: 121.0.

Codul care dă eroarea
JAVA
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
import org.springframework.stereotype.*;
import org.springframework.beans.factory.annotation.*;
import org.springframework.http.*;
import java.util.*;

@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

@Service
class FacturaService {
    @Autowired
    TvaService tva;

    String prefix() {
        return "FCT";
    }

    String total(double suma) {
        return tva.clientCurent() + ": " + tva.cuTva(suma);
    }
}

@Service
class TvaService {
    @Autowired
    ClientService clienti;

    double cuTva(double suma) {
        return suma * 1.21;
    }

    String clientCurent() {
        return clienti.eticheta();
    }
}

@Service
class ClientService {
    @Autowired
    FacturaService facturi;

    String eticheta() {
        return facturi.prefix() + "-Ana";
    }
}

@RestController
class FacturaController {
    private final FacturaService service;

    FacturaController(FacturaService service) {
        this.service = service;
    }

    @GetMapping("/facturi/total")
    String total(@RequestParam double suma) {
        return service.total(suma);
    }
}
După reparație, programul afișează
Tomcat started on port 8080 (http)
Started Application
GET /facturi/total?suma=100 → 200
FCT-Ana: 121.0
Indiciu

Elimină dependența ClientService → FacturaService și păstrează prefixul direct în ClientService.

Alte forme ale mesajului

  • Requested bean is currently in creation: Is there an unresolvable circular reference?

Cum o eviți pe viitor

  • Desenează dependențele modulului: săgețile trebuie să meargă într-o singură direcție.
  • Când o clasă „de jos” are nevoie de una „de sus”, mută logica sau folosește un eveniment.
  • Nu activa spring.main.allow-circular-references: doar ascunde designul încurcat.
  • Preferă injectarea prin constructor: un ciclu nou oprește pornirea imediat, nu rămâne ascuns până la prima cerere.

Întrebări frecvente

Cum găsesc ciclul într-un proiect mare?

Citește desenul din APPLICATION FAILED TO START sau șirul de Error creating bean with name din stivă: fiecare nume e o verigă din cerc.

E aceeași eroare ca form a cycle?

Da, sunt două fețe ale aceleiași probleme: desenul este rezumatul Spring Boot, excepția este forma tehnică din stivă.

Erori înrudite

← Toate erorile Spring Boot

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ță Spring Boot de la zero, cu exerciții la fiecare lecție

Curs Spring Boot și REST API: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 18 lecții sunt gratuite.