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

Parameter 0 of constructor in CatalogClient required a bean of type 'org.springframework.web.client.RestTemplate' that could not be found.

Pe scurt

Spring Boot nu creează automat un RestTemplate, ci doar un RestTemplateBuilder. Declară o metodă @Bean care întoarce RestTemplate (de exemplu builder.build()) într-o clasă @Configuration, apoi injectează-l.

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

Ce înseamnă

Mulți presupun că RestTemplate vine gata făcut odată cu spring-boot-starter-web. Nu e așa: Spring Boot configurează un RestTemplateBuilder (cu convertoarele JSON și setările aplicației), dar nu și un RestTemplate, pentru că fiecare aplicație îl vrea configurat altfel (adresă de bază, timeout-uri, autentificare).

Mesajul spune că primul parametru al constructorului din CatalogClient cere un RestTemplate și că în container nu există niciunul. Aceeași situație apare la WebClient (există doar WebClient.Builder) și, în Boot 3.2+, la RestClient (există RestClient.Builder).

Repararea standard: o clasă @Configuration cu o metodă @Bean RestTemplate restTemplate(RestTemplateBuilder builder) care întoarce builder.build(). Din acel moment orice clasă poate cere RestTemplate în constructor.

De ce apare: cauzele frecvente

1Ai presupus că RestTemplate e creat automat

Greșit
JAVA
@Service
class CatalogClient {
    CatalogClient(RestTemplate rest) { }
}
Corect
JAVA
@Configuration
class ClientConfig {
    @Bean
    RestTemplate restTemplate(RestTemplateBuilder builder) {
        return builder.build();
    }
}

Boot oferă doar builder-ul. Metoda @Bean transformă rezultatul lui build() într-un bean care poate fi injectat.

2Metoda @Bean e într-o clasă fără @Configuration

Greșit
JAVA
class ClientConfig {
    @Bean RestTemplate rest() { return new RestTemplate(); }
}
Corect
JAVA
@Configuration
class ClientConfig {
    @Bean RestTemplate rest() { return new RestTemplate(); }
}

Metodele @Bean sunt citite doar din clase pe care Spring le gestionează. Fără @Configuration, metoda e ignorată.

Repară tu

Repară eroarea, direct în pagină

CatalogClient cere un RestTemplate în constructor, iar aplicația nu pornește: required a bean of type 'org.springframework.web.client.RestTemplate' that could not be found. Declară bean-ul în ClientConfig, astfel încât GET /client/info să răspundă Client gata.

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.*;
import org.springframework.context.annotation.*;
import org.springframework.web.client.RestTemplate;
import org.springframework.boot.web.client.RestTemplateBuilder;

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

@Configuration
class ClientConfig {
    // TODO: declară aici bean-ul RestTemplate
}

@Service
class CatalogClient {
    private final RestTemplate rest;

    CatalogClient(RestTemplate rest) {
        this.rest = rest;
    }

    String stare() {
        return rest != null ? "Client gata" : "Fără client";
    }
}

@RestController
class InfoController {
    private final CatalogClient client;

    InfoController(CatalogClient client) {
        this.client = client;
    }

    @GetMapping("/client/info")
    String info() {
        return client.stare();
    }
}
După reparație, programul afișează
Tomcat started on port 8080 (http)
Started Application
GET /client/info → 200
Client gata
Indiciu

Adaugă în ClientConfig o metodă @Bean care primește RestTemplateBuilder și întoarce builder.build().

Alte forme ale mesajului

  • Field restTemplate in CatalogService required a bean of type 'org.springframework.web.client.RestTemplate' that could not be found.
  • required a bean of type 'org.springframework.web.reactive.function.client.WebClient' that could not be found.

Cum o eviți pe viitor

  • Declară clienții HTTP o singură dată, într-o clasă @Configuration, cu setările lor (adresă, timeout-uri).
  • Pornește de la builder-ul oferit de Boot (RestTemplateBuilder, RestClient.Builder), ca să păstrezi convertoarele JSON configurate.
  • În proiectele noi pe Boot 3.2+, preferă RestClient, care are un API mai simplu.

Întrebări frecvente

Pot scrie direct new RestTemplate() în serviciu?

Merge, dar pierzi configurarea comună și nu îl mai poți înlocui ușor în teste. Un bean declarat o dată e mai ușor de întreținut.

De ce Boot nu îl creează singur?

Pentru că nu există o configurare potrivită pentru toți: fiecare client are alte adrese, timeout-uri și autentificare. Boot îți dă builder-ul și te lasă să alegi.

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.