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

I/O error on GET request for "http://stoc/stoc/A1": stoc

Pe scurt

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.

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

Ce înseamnă

Într-o arhitectură cu service discovery (Eureka, Consul, Kubernetes), serviciile se cheamă după numele logic, spring.application.name: http://stoc/stoc/A1. Numele e transformat într-o adresă reală (localhost:8081) de Spring Cloud LoadBalancer, dar numai pentru clienții marcați cu @LoadBalanced.

Dacă folosești RestClient.create() sau un new RestTemplate(), nimeni nu traduce numele. Clientul încearcă să rezolve stoc prin DNS, nu găsește gazda și aruncă ResourceAccessException: I/O error on GET request for "http://stoc/stoc/A1": stoc, cu cauza UnknownHostException: stoc. Mesajul pare ciudat pentru că textul excepției este chiar numele gazdei.

Remediul: un bean RestClient.Builder (sau RestTemplate) adnotat cu @LoadBalanced, injectat în client. Un client creat cu new sau cu create() ocolește bean-ul și, odată cu el, load balancer-ul.

De ce apare: cauzele frecvente

1Client creat direct

Greșit
JAVA
this.http = RestClient.create();
Corect
JAVA
@Bean @LoadBalanced
RestClient.Builder restClientBuilder() { return RestClient.builder(); }

StocClient(RestClient.Builder builder) { this.http = builder.build(); }

Doar clienții construiți din builder-ul @LoadBalanced înțeleg numele de servicii.

2RestTemplate fără @LoadBalanced

Greșit
JAVA
@Bean RestTemplate restTemplate() { return new RestTemplate(); }
Corect
JAVA
@Bean @LoadBalanced RestTemplate restTemplate() { return new RestTemplate(); }

Aceeași regulă pentru RestTemplate.

3Lipsește dependența

Greșit
JAVA
<!-- doar spring-boot-starter-web -->
Corect
JAVA
<artifactId>spring-cloud-starter-loadbalancer</artifactId>
<!-- sau un client de discovery, de ex. eureka-client -->

Fără LoadBalancer pe classpath, @LoadBalanced nu are efect.

Repară tu

Repară eroarea, direct în pagină

Magazinul cheamă serviciul de stoc după nume, http://stoc/..., dar primește 500 cu I/O error on GET request for "http://stoc/stoc/A1": stoc. Adaugă în MagazinApp un bean RestClient.Builder cu @LoadBalanced și construiește clientul din el.

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.client.loadbalancer.LoadBalanced;

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

    @Service
    static class StocClient {
        private final RestClient http;

        StocClient() {
            this.http = RestClient.create();
        }

        Stoc stoc(String cod) {
            return http.get().uri("http://stoc/stoc/{cod}", cod).retrieve().body(Stoc.class);
        }
    }

    @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

Bean-ul @LoadBalanced se injectează în constructorul StocClient, în loc de RestClient.create().

Alte forme ale mesajului

  • java.net.UnknownHostException: stoc
  • org.springframework.web.client.ResourceAccessException: I/O error on GET request for "http://stoc/stoc/A1": stoc
  • java.net.UnknownHostException: stoc: nodename nor servname provided, or not known

Cum o eviți pe viitor

  • Definește un singur bean RestClient.Builder cu @LoadBalanced și injectează-l peste tot.
  • Nu crea clienți HTTP cu new sau create() pentru apeluri între servicii.
  • Verifică în registrul de servicii (de exemplu, Eureka) că serviciul apare cu numele folosit în URL.
  • Pentru URL-uri externe (API-uri publice), folosește un builder separat, fără @LoadBalanced.

Întrebări frecvente

De ce mesajul conține doar „stoc”?

Pentru că textul lui UnknownHostException este numele gazdei care nu a putut fi rezolvată, iar Spring îl pune după două puncte.

Pot folosi același client și pentru API-uri externe?

Nu e recomandat: un client @LoadBalanced caută orice gazdă în registrul de servicii. Ține un builder separat pentru URL-uri externe.

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.