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ă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
ResourceAccessException: I/O error on GET request for "http://localhost:8082/stoc/A1": Connection refused înseamnă că cererea nici nu a plecat: sistemul de operare a încercat să deschidă conexiunea TCP, iar la acel port nu răspundea niciun proces. Nu e un cod HTTP de la serviciu, ci o eroare de rețea, deci Spring o semnalează ca excepție, iar endpoint-ul tău răspunde 500.
Cauze, de la cea mai frecventă:
- portul din URL e greșit (serviciul rulează pe 8081, clientul cheamă 8082);
- serviciul apelat nu e pornit sau a căzut la pornire;
- în Docker Compose,
localhostînseamnă containerul curent, nu celălalt serviciu: folosește numele serviciului (http://stoc:8081); - un firewall sau o adresă de bind restrictivă.
URL-ul din mesaj e exact cel apelat, deci compară-l cu portul din jurnalul serviciului țintă (Tomcat started on port 8081).
De ce apare: cauzele frecvente
1Port greșit în URL
RestClient.builder().baseUrl("http://localhost:8082").build();RestClient.builder().baseUrl("http://localhost:8081").build();Portul trebuie să fie cel pe care pornește serviciul țintă.
2localhost în Docker Compose
stoc.url=http://localhost:8081stoc.url=http://stoc:8081În rețeaua Compose, fiecare serviciu e accesibil prin numele lui.
3URL-ul e scris în cod
RestClient.create().get().uri("http://localhost:8081/stoc/{cod}", cod)@Value("${stoc.url}") String url;
RestClient.builder().baseUrl(url).build();Cu URL-ul în proprietăți, îl schimbi pe medii fără să modifici codul.
Repară eroarea, direct în pagină
Magazinul cere stocul de la serviciul stoc, dar primește 500 cu I/O error on GET request for "http://localhost:8082/stoc/A1": Connection refused. Uită-te pe ce port pornește serviciul de stoc și corectează adresa din StocClient.
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.*;
/* 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 = RestClient.builder().baseUrl("http://localhost:8082").build();
Stoc stoc(String cod) {
return http.get().uri("/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
Compară portul din baseUrl cu server.port din StocApp.properties.
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.*;
/* 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 = RestClient.builder().baseUrl("http://localhost:8081").build();
Stoc stoc(String cod) {
return http.get().uri("/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
Serviciul de stoc pornește pe portul 8081 (server.port=8081), iar clientul îl căuta pe 8082, unde nu asculta nimic, deci conexiunea era refuzată imediat. Cu portul corect, cererea ajunge la StocController. În proiect, adresa ar sta în proprietăți (stoc.url), ca s-o poți schimba fără cod.
Alte forme ale mesajului
org.springframework.web.client.ResourceAccessException: I/O error on GET request for "http://localhost:8081/stoc/A1": Connection refusedjava.net.ConnectException: Connection refusedfeign.RetryableException: Connection refused executing GET http://localhost:8081/stoc/A1
Cum o eviți pe viitor
- Ține URL-urile serviciilor în proprietăți, pe medii.
- Pornește serviciile în ordinea dependențelor sau tratează indisponibilitatea (retry, circuit breaker, mesaj clar).
- Folosește service discovery (Eureka, Kubernetes) în loc de porturi scrise de mână.
- Prinde
ResourceAccessExceptionși răspunde 503, nu 500.
Întrebări frecvente
Care e diferența față de Read timed out?
Connection refused: nimeni nu ascultă la port, eroarea vine imediat. Read timed out: conexiunea s-a deschis, dar serviciul n-a răspuns la timp.
Ce cod HTTP dau clientului meu?
503 Service Unavailable (sau 502 Bad Gateway), cu un mesaj clar. 500 sugerează un bug în serviciul tău.
Erori înrudite
I/O error on GET request for "http://localhost:8081/stoc/A1": Read timed out Conexiunea la serviciul apelat s-a deschis, dar răspunsul n-a venit în timpul de citire configurat (read timeout). Serviciul e lent sau blocat. Pune un timeout rezonabil și tratează depășirea lui: răspunde 503, folosește o valoare de rezervă sau un circuit breaker. HttpClientErrorException$NotFound: 404 Not Found: "{"status":404,"error":"Not Found","path":"/stoc/Z9"}" Serviciul apelat a răspuns 404, iar RestClient/RestTemplate transformă orice răspuns 4xx într-o excepție HttpClientErrorException. Neprinsă, devine 500 în serviciul tău. Verifică URL-ul apelat și tratează 404 explicit (try/catch sau onStatus), răspunzând clientului tău cu 404. 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.
