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

UnsatisfiedDependencyException: Error creating bean with name 'raportController': Unsatisfied dependency expressed through constructor parameter 0

Pe scurt

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 (sau through field 'service'): ce dependență a lipsit;
  • după aceea urmează nested exception / Caused by, cu motivul real: de obicei NoSuchBeanDefinitionException: 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

Greșit
JAVA
@RestController class RaportController {
    RaportController(RaportService s) { }
}
@Service class RaportService {
    RaportService(Exportator e) { }
}
class Exportator { }
Corect
JAVA
@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

Greșit
JAVA
@Service class RaportService {
    RaportService() { throw new IllegalStateException("fără șablon"); }
}
Corect
JAVA
@Service class RaportService {
    RaportService() { }
}

Dacă un bean dependent nu se poate crea, eroarea lui apare ca Caused by sub UnsatisfiedDependencyException.

Repară tu

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.

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);
    }
}

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);
    }
}
După reparație, programul afișează
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.

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 by conț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 @SpringBootTest gol 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

← 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.