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.
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
this.http = RestClient.create();@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
@Bean RestTemplate restTemplate() { return new RestTemplate(); }@Bean @LoadBalanced RestTemplate restTemplate() { return new RestTemplate(); }Aceeași regulă pentru RestTemplate.
3Lipsește dependența
<!-- doar spring-boot-starter-web --><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ă 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.
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);
}
}
}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().
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.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);
}
@Bean
@LoadBalanced
RestClient.Builder restClientBuilder() {
return RestClient.builder();
}
@Service
static class StocClient {
private final RestClient http;
StocClient(RestClient.Builder builder) {
this.http = builder.build();
}
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);
}
}
}De ce merge
Numele stoc din URL este numele logic al serviciului, nu o gazdă DNS. Doar un client construit din builder-ul @LoadBalanced îl traduce în adresa reală, localhost:8081, prin Spring Cloud LoadBalancer. Clientul creat cu RestClient.create() ocolea bean-ul și încerca un DNS care nu știe de stoc.
Alte forme ale mesajului
java.net.UnknownHostException: stocorg.springframework.web.client.ResourceAccessException: I/O error on GET request for "http://stoc/stoc/A1": stocjava.net.UnknownHostException: stoc: nodename nor servname provided, or not known
Cum o eviți pe viitor
- Definește un singur bean
RestClient.Buildercu@LoadBalancedși injectează-l peste tot. - Nu crea clienți HTTP cu
newsaucreate()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
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://localhost:8082/stoc/A1": Connection refused Clientul HTTP (RestClient, RestTemplate, Feign) nu s-a putut conecta la serviciul apelat: la adresa și portul din URL nu ascultă nimic. Serviciul e oprit, portul sau gazda sunt greșite, ori în Docker folosești localhost în loc de numele containerului. Verifică URL-ul și că serviciul rulează. 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. Î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.
