BeanCurrentlyInCreationException: Error creating bean with name 'facturaService': Requested bean is currently in creation: Is there an unresolvable circular reference?
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
@Service class FacturaService { @Autowired ClientService c; }
@Service class ClientService { @Autowired FacturaService f; }@Service class FacturaService { @Autowired ClientService c; }
@Service class ClientService { } // nu mai cere FacturaServiceChiar și cu câmpuri, Boot 2.6+ refuză ciclul. Elimină direcția care nu e necesară.
2Ciclu prin trei clase
FacturaService -> TvaService -> ClientService -> FacturaServiceFacturaService -> TvaService
ClientService -> TvaServiceDacă 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ă 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.
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);
}
}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.
Reparația
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 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 {
String eticheta() {
return "FCT-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);
}
}De ce merge
Cercul avea trei verigi, iar ultima, ClientService → FacturaService, era inutilă: îi trebuia doar textul FCT. Fără ea, dependențele merg într-o singură direcție: controller → FacturaService → TvaService → ClientService. Spring le poate crea de la coadă la cap. Când o valoare e folosită de mai multe clase, o pui într-o constantă sau în configurare, nu o ceri de la o clasă „de sus”.
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
The dependencies of some of the beans in the application context form a cycle Două sau mai multe bean-uri depind unul de altul în cerc (A cere B, B cere A), iar Spring Boot (de la 2.6) refuză dependențele circulare. Rupe cercul: mută logica comună într-o a treia clasă sau elimină dependența inutilă. UnsatisfiedDependencyException: Error creating bean with name 'raportController': Unsatisfied dependency expressed through constructor parameter 0 Spring nu a putut crea bean-ul din mesaj pentru că una dintre dependențele lui (parametrul indicat) nu a putut fi rezolvată. Citește cauza din finalul stivei (No qualifying bean, alt bean care nu se creează) și repar-o acolo. Failed to instantiate [RaportService]: No default constructor found Clasa are mai mulți constructori și niciunul nu e marcat cu @Autowired, așa că Spring caută un constructor fără parametri, care nu există. Păstrează un singur constructor sau marchează-l cu @Autowired pe cel folosit pentru injectare. Î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.
