Parameter 0 of constructor in ProdusController required a bean of type 'StocClient' that could not be found
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
@EnableFeignClientspe clasa@SpringBootApplicationsau 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 = "...")sauclients = 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
@SpringBootApplication
class MagazinApp { ... }@SpringBootApplication
@EnableFeignClients
class MagazinApp { ... }Adnotarea activează scanarea și generarea clienților Feign.
2Client în alt pachet
package ro.magazin; // MagazinApp
package ro.clienti; // StocClient@EnableFeignClients(basePackages = "ro.clienti")Scanarea Feign trebuie să includă pachetul interfeței.
3Interfață fără @FeignClient
interface StocClient { ... }@FeignClient(name = "stoc")
interface StocClient { ... }Doar interfețele adnotate primesc o implementare.
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.
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);
}
}
}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.
Reparația
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
@EnableFeignClients
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);
}
}
}De ce merge
@FeignClient doar descrie apelul. Implementarea interfeței e creată de OpenFeign numai pentru clienții găsiți de @EnableFeignClients. Fără ea, StocClient rămânea o interfață fără bean, iar constructorul controllerului nu putea fi apelat. Acum magazinul pornește și primește stocul prin Feign, iar testul de pornire a contextului ar fi prins problema înainte de rulare.
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
@EnableFeignClientspe clasa principală imediat ce adaugi dependența OpenFeign. - Ține interfețele Feign sub pachetul clasei principale sau declară explicit
basePackages. - Scrie un test
@SpringBootTestcare 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
FeignException$NotFound: [404 Not Found] during [GET] to [http://localhost:8081/stoc/Z9] [StocClient#stoc(String)] Clientul Feign a primit 404 de la serviciul apelat și, implicit, aruncă FeignException$NotFound. Neprinsă, devine 500 în serviciul tău. Verifică ruta din interfața @FeignClient și tratează resursa lipsă: prinde excepția, folosește dismiss404 sau un ErrorDecoder propriu. No instances available for stocc Load balancer-ul a primit un nume de serviciu, dar registrul de servicii nu are nicio instanță pornită cu acel nume. Fie numele din URL e scris greșit, fie serviciul nu s-a înregistrat (nu rulează, alt spring.application.name, alt registru). Compară numele cu cel din Eureka. I/O error on GET request for "http://stoc/stoc/A1": stoc Clientul a apelat un serviciu după numele lui logic (http://stoc/...), dar fără load balancer numele e tratat ca un nume de gazdă DNS, care nu există (UnknownHostException). Pune @LoadBalanced pe bean-ul RestClient.Builder sau RestTemplate și construiește clientul din acel bean. Î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.
