...
Eroare Spring Boot · Apeluri între servicii și Spring Cloud

Parameter 0 of constructor in ProdusController required a bean of type 'StocClient' that could not be found

Pe scurt

Ai declarat o interfață @FeignClient, dar Spring nu a creat implementarea ei, deci nu are ce injecta. Aproape mereu lipsește @EnableFeignClients pe clasa principală, sau interfața e într-un pachet pe care scanarea Feign nu-l acoperă. Adaugă adnotarea (cu basePackages, dacă e nevoie).

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

Ce înseamnă

Interfețele @FeignClient nu sunt bean-uri obișnuite: implementarea lor e generată de OpenFeign, dar numai pentru interfețele găsite de @EnableFeignClients. Fără această adnotare, Spring vede doar o interfață fără implementare, iar orice clasă care o cere în constructor oprește pornirea: APPLICATION FAILED TO START cu required a bean of type 'StocClient' that could not be found.

Cauze:

  • lipsește @EnableFeignClients pe clasa @SpringBootApplication sau pe o clasă @Configuration;
  • interfața e într-un pachet din afara pachetului clasei principale: scanarea pornește de la pachetul clasei adnotate, deci ai nevoie de @EnableFeignClients(basePackages = "...") sau clients = StocClient.class;
  • lipsește dependența spring-cloud-starter-openfeign, caz în care nici adnotarea nu se compilează.

Mesajul e același ca pentru orice bean lipsă. Indiciul e că tipul cerut e o interfață @FeignClient.

De ce apare: cauzele frecvente

1Lipsește @EnableFeignClients

Greșit
JAVA
@SpringBootApplication
class MagazinApp { ... }
Corect
JAVA
@SpringBootApplication
@EnableFeignClients
class MagazinApp { ... }

Adnotarea activează scanarea și generarea clienților Feign.

2Client în alt pachet

Greșit
JAVA
package ro.magazin;  // MagazinApp
package ro.clienti; // StocClient
Corect
JAVA
@EnableFeignClients(basePackages = "ro.clienti")

Scanarea Feign trebuie să includă pachetul interfeței.

3Interfață fără @FeignClient

Greșit
JAVA
interface StocClient { ... }
Corect
JAVA
@FeignClient(name = "stoc")
interface StocClient { ... }

Doar interfețele adnotate primesc o implementare.

Repară tu

Repară eroarea, direct în pagină

Magazinul nu pornește: ProdusController cere un StocClient, interfața @FeignClient, dar Spring nu găsește niciun bean de acest tip. Activează clienții Feign pe clasa MagazinApp, ca stocul pentru A1 să ajungă la magazin.

Codul care dă eroarea
JAVA
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;
import org.springframework.http.HttpStatus;
import org.springframework.stereotype.Service;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.client.*;
import org.springframework.web.server.ResponseStatusException;
import java.util.*;
import org.springframework.cloud.openfeign.*;
import feign.FeignException;

/* StocApp.properties
spring.application.name=stoc
server.port=8081
*/
/* MagazinApp.properties
server.port=8080
server.error.include-message=always
*/

record Stoc(String cod, int bucati) { }

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

    @RestController
    static class StocController {
        private final Map<String, Integer> stoc = Map.of("A1", 5, "B2", 0);

        @GetMapping("/stoc/{cod}")
        Stoc stoc(@PathVariable String cod) {
            Integer n = stoc.get(cod);
            if (n == null) {
                throw new ResponseStatusException(HttpStatus.NOT_FOUND, "Cod necunoscut: " + cod);
            }
            return new Stoc(cod, n);
        }
    }
}

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

    @FeignClient(name = "stoc", url = "http://localhost:8081")
    interface StocClient {
        @GetMapping("/stoc/{cod}")
        Stoc stoc(@PathVariable("cod") String cod);
    }

    @RestController
    static class ProdusController {
        private final StocClient stoc;

        ProdusController(StocClient stoc) {
            this.stoc = stoc;
        }

        @GetMapping("/produse/{cod}/stoc")
        Stoc stoc(@PathVariable String cod) {
            return stoc.stoc(cod);
        }
    }
}
După reparație, programul afișează
Tomcat started on port 8081 (http)
Started StocApp
Tomcat started on port 8080 (http)
Started MagazinApp
GET /produse/A1/stoc → 200
{"cod":"A1","bucati":5}
Indiciu

Clienții Feign se activează cu o adnotare pusă lângă @SpringBootApplication.

Alte forme ale mesajului

  • Parameter 0 of constructor in ro.magazin.ProdusController required a bean of type 'ro.clienti.StocClient' that could not be found.
  • No qualifying bean of type 'StocClient' available

Cum o eviți pe viitor

  • Pune @EnableFeignClients pe clasa principală imediat ce adaugi dependența OpenFeign.
  • Ține interfețele Feign sub pachetul clasei principale sau declară explicit basePackages.
  • Scrie un test @SpringBootTest care doar pornește contextul: prinde bean-urile lipsă înainte de rulare.
  • Verifică dependența spring-cloud-starter-openfeign și versiunea Spring Cloud compatibilă cu Boot.

Întrebări frecvente

De ce nu e suficient @FeignClient?

@FeignClient doar descrie clientul. @EnableFeignClients pornește scanarea care găsește aceste interfețe și le creează implementarea.

Pot pune @EnableFeignClients pe altă clasă?

Da, pe orice clasă @Configuration. Scanarea pornește atunci de la pachetul acelei clase.

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.