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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
UnsatisfiedDependencyException este excepția „ambalaj” pe care o vezi în stiva de apeluri când injectarea pică. Bucățile ei:
Error creating bean with name 'raportController': bean-ul care nu s-a putut crea;Unsatisfied dependency expressed through constructor parameter 0(sauthrough field 'service'): ce dependență a lipsit;- după aceea urmează
nested exception/Caused by, cu motivul real: de obiceiNoSuchBeanDefinitionException: No qualifying bean of type ...sau eroarea unui alt bean din lanț.
Spring Boot rezumă de obicei totul în blocul APPLICATION FAILED TO START (de exemplu required a bean of type ... that could not be found), dar în loguri, în teste sau în aplicații fără analizor vezi stiva lungă. Regula: sari peste primele rânduri și citește ultimul Caused by. Acolo e problema de reparat, adesea într-o clasă diferită de cea din primul rând.
De ce apare: cauzele frecvente
1O dependență din lanț nu este bean
@RestController class RaportController {
RaportController(RaportService s) { }
}
@Service class RaportService {
RaportService(Exportator e) { }
}
class Exportator { }@Component
class Exportator { }Primul rând vorbește despre controller, dar cauza e la capătul lanțului: Exportator nu e bean, deci nici RaportService, nici controller-ul nu pot fi create.
2Dependența aruncă o excepție la creare
@Service class RaportService {
RaportService() { throw new IllegalStateException("fără șablon"); }
}@Service class RaportService {
RaportService() { }
}Dacă un bean dependent nu se poate crea, eroarea lui apare ca Caused by sub UnsatisfiedDependencyException.
Repară eroarea, direct în pagină
Aplicația nu pornește din cauza unei dependențe nesatisfăcute în lanțul RaportController → RaportService → Exportator. Găsește veriga lipsă și repar-o ca GET /rapoarte/vanzari să răspundă Raport vanzari exportat ca CSV.
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);
}
}
class Exportator {
String exporta(String nume) {
return "Raport " + nume + " exportat ca CSV";
}
}
@Service
class RaportService {
private final Exportator exportator;
RaportService(Exportator exportator) {
this.exportator = exportator;
}
String genereaza(String nume) {
return exportator.exporta(nume);
}
}
@RestController
class RaportController {
private final RaportService service;
RaportController(RaportService service) {
this.service = service;
}
@GetMapping("/rapoarte/{nume}")
String raport(@PathVariable String nume) {
return service.genereaza(nume);
}
}Tomcat started on port 8080 (http) Started Application GET /rapoarte/vanzari → 200 Raport vanzari exportat ca CSV
Indiciu
Mesajul arată ce clasă lipsește; nu e neapărat controller-ul.
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);
}
}
@Component
class Exportator {
String exporta(String nume) {
return "Raport " + nume + " exportat ca CSV";
}
}
@Service
class RaportService {
private final Exportator exportator;
RaportService(Exportator exportator) {
this.exportator = exportator;
}
String genereaza(String nume) {
return exportator.exporta(nume);
}
}
@RestController
class RaportController {
private final RaportService service;
RaportController(RaportService service) {
this.service = service;
}
@GetMapping("/rapoarte/{nume}")
String raport(@PathVariable String nume) {
return service.genereaza(nume);
}
}De ce merge
Controller-ul și serviciul erau corecte; lanțul se rupea la capăt, la Exportator, care nu era bean. Spring încearcă să creeze controller-ul, are nevoie de serviciu, serviciul are nevoie de exportator, iar acolo se oprește. De aceea mesajul pornește de la un bean, dar cauza e la altul. Cu @Component pe Exportator, toate cele trei bean-uri se creează în ordine.
Alte forme ale mesajului
UnsatisfiedDependencyException: Error creating bean with name 'raportService': Unsatisfied dependency expressed through field 'exportator'
Cum o eviți pe viitor
- Citește stiva de jos în sus: ultimul
Caused byconține cauza reală. - Ține lanțurile de dependențe scurte și clare (controller → service → repository).
- Pornește aplicația des în timpul dezvoltării: o dependență nouă greșită se vede imediat, nu după zece modificări.
- Scrie un test
@SpringBootTestgol care doar încarcă contextul: prinde aceste erori în CI.
Întrebări frecvente
De ce mesajul indică o clasă pe care n-am modificat-o?
Pentru că Spring raportează întâi bean-ul pe care încerca să-l creeze. Problema este într-o dependență a lui, adesea două sau trei niveluri mai jos în lanț.
E același lucru cu NoSuchBeanDefinitionException?
Nu chiar: NoSuchBeanDefinitionException spune că un tip nu are bean; UnsatisfiedDependencyException o împachetează și spune cine avea nevoie de el.
Erori înrudite
Parameter 0 of constructor in ComandaService required a bean of type 'StocService' that could not be found. Constructorul unui bean cere un parametru (aici primul, indexul 0) pentru care Spring nu are niciun bean de tipul respectiv. Fă clasa dependenței bean (@Service, @Component sau o metodă @Bean) sau corectează tipul parametrului. NoSuchBeanDefinitionException: No qualifying bean of type 'Notificator' available Ai cerut containerului un bean de un tip pentru care nu există niciunul (de obicei cu getBean sau în timpul injectării). Creează bean-ul (@Component, @Bean) sau verifică dacă e condiționat de un profil ori de o proprietate care nu e activă. Field produsService in ProdusController required a bean of type 'ProdusService' that could not be found. Spring a încercat să injecteze câmpul marcat cu @Autowired, dar nu există niciun bean de tipul cerut. De obicei clasa nu are @Service / @Component sau stă în afara pachetului scanat. Adaugă adnotarea pe clasă (sau un @Bean) și aplicația pornește. Î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.
