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

Field produsService in ProdusController required a bean of type 'ProdusService' that could not be found.

Pe scurt

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.

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

Ce înseamnă

Mesajul apare în blocul APPLICATION FAILED TO START și se citește așa: câmpul produsService din clasa ProdusController cere (prin @Autowired) un obiect de tipul ProdusService, dar în containerul Spring nu există niciun bean de acest tip. Spring nu poate construi controller-ul, așa că oprește toată aplicația.

Un obiect devine bean doar dacă Spring îl creează: clasa are o adnotare stereotip (@Component, @Service, @Repository, @Controller) și se află în pachetul clasei @SpringBootApplication sau într-un subpachet al lui, ori este întors de o metodă @Bean dintr-o clasă @Configuration.

Sub Description vezi exact câmpul și tipul. Sub Action Spring sugerează Consider defining a bean of type 'ProdusService' in your configuration. Pornește de la tipul din mesaj: caută clasa și verifică adnotarea, pachetul și, dacă tipul e o interfață, că există o implementare care e bean.

De ce apare: cauzele frecvente

1Clasa serviciului nu are @Service

Greșit
JAVA
class ProdusService {
    List<String> toate() { return List.of("Mouse"); }
}
Corect
JAVA
@Service
class ProdusService {
    List<String> toate() { return List.of("Mouse"); }
}

Fără adnotare, Spring nu știe că trebuie să creeze un obiect ProdusService, deci nu are ce injecta în câmp.

2Clasa este în afara pachetului scanat

Greșit
JAVA
// com.magazin.web.Application (@SpringBootApplication)
// com.servicii.ProdusService (@Service)
Corect
JAVA
// com.magazin.Application (@SpringBootApplication)
// com.magazin.servicii.ProdusService (@Service)

Scanarea pornește din pachetul clasei principale și coboară în subpachete. Un pachet „vecin” nu este scanat, chiar dacă clasa are @Service.

3Interfața nu are nicio implementare bean

Greșit
JAVA
interface Notificari { void trimite(String m); }

@RestController
class ComandaController {
    @Autowired Notificari notificari;
}
Corect
JAVA
interface Notificari { void trimite(String m); }

@Service
class NotificariEmail implements Notificari {
    public void trimite(String m) { }
}

Spring injectează o interfață doar dacă găsește un bean care o implementează. Interfața singură nu poate fi creată.

Repară tu

Repară eroarea, direct în pagină

Aplicația nu pornește și afișează Field produsService in ProdusController required a bean of type 'ProdusService' that could not be found. Repar-o ca GET /produse să răspundă cu lista de produse.

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 ProdusService {
    List<String> toate() {
        return List.of("Mouse", "Tastatură");
    }
}

@RestController
class ProdusController {
    @Autowired
    ProdusService produsService;

    @GetMapping("/produse")
    List<String> produse() {
        return produsService.toate();
    }
}
După reparație, programul afișează
Tomcat started on port 8080 (http)
Started Application
GET /produse → 200
["Mouse","Tastatură"]
Indiciu

Uită-te la clasa ProdusService: îi lipsește ceva ca Spring să o creeze.

Alte forme ale mesajului

  • Field repo in ProdusService required a bean of type 'ProdusRepository' that could not be found.
  • Consider defining a bean of type 'ProdusService' in your configuration.

Cum o eviți pe viitor

  • Pune adnotarea stereotip (@Service, @Component, @Repository) imediat ce creezi o clasă pe care o vei injecta.
  • Ține clasa @SpringBootApplication în pachetul rădăcină al proiectului (com.firma.app), iar restul în subpachete.
  • Preferă injectarea prin constructor: dependențele lipsă se văd imediat, iar clasa se poate testa și fără Spring.
  • Când tipul cerut e o interfață, verifică faptul că există exact o implementare marcată ca bean.

Întrebări frecvente

De ce merge în teste, dar nu la pornire (sau invers)?

Testele pot porni alt context (de exemplu @WebMvcTest încarcă doar controllerele) sau pot adăuga bean-uri proprii. Compară ce pachete și ce configurări încarcă fiecare.

Rezolv eroarea dacă pun @Autowired(required = false)?

Aplicația pornește, dar câmpul rămâne null și primești NullPointerException la prima folosire. Folosește-l doar pentru dependențe cu adevărat opționale.

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.