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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
ResourceAccessException: I/O error on GET request for "...": Read timed out apare când clientul a trimis cererea, dar nu a primit răspunsul în intervalul de read timeout. Spre deosebire de Connection refused, serviciul țintă există și a acceptat conexiunea; doar că e prea lent: o interogare grea, o bază de date blocată, un apel în lanț către alt serviciu lent, o pauză de garbage collector.
Timeout-urile sunt o protecție: fără ele, un serviciu lent îți ține firele de execuție ocupate până când nici serviciul tău nu mai răspunde. În Spring Boot 3.4+ se configurează cu spring.http.client.read-timeout=2s și spring.http.client.connect-timeout=1s (pentru clienții creați din builder-ele injectate), sau direct pe ClientHttpRequestFactory.
Ce faci la depășire depinde de operație: răspunzi 503, folosești o valoare de rezervă sau reîncerci o dată. Iar dacă serviciul e lent constant, problema reală e de performanță acolo.
De ce apare: cauzele frecvente
1Depășirea nu e tratată
return http.get().uri("/stoc/{cod}", cod).retrieve().body(Stoc.class);try {
return http.get().uri("/stoc/{cod}", cod).retrieve().body(Stoc.class);
} catch (ResourceAccessException e) {
return new Stoc(cod, -1); // stoc necunoscut
}Răspunzi rapid cu o valoare de rezervă în loc de 500.
2Timeout prea mic pentru o operație legitim lentă
spring.http.client.read-timeout=200msspring.http.client.read-timeout=2sTimeout-ul trebuie să fie puțin peste timpul normal de răspuns, nu sub el.
3Lipsește timeout-ul cu totul
RestClient.create()RestClient.builder()
.requestFactory(factoryCuTimeout)
.build();Fără timeout, un apel poate aștepta foarte mult și blochează fire de execuție.
Repară eroarea, direct în pagină
Serviciul de stoc răspunde în 2 secunde, iar clientul are read-timeout=500ms, deci magazinul dă 500 cu Read timed out. Prinde depășirea în StocClient și întoarce un stoc „necunoscut”: new Stoc(cod, -1).
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
spring.http.client.read-timeout=500ms
*/
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(RestClient.Builder builder) {
this.http = 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);
}
}
}Tomcat started on port 8081 (http)
Started StocApp
Tomcat started on port 8080 (http)
Started MagazinApp
GET /produse/A1/stoc → 200
{"cod":"A1","bucati":-1}Indiciu
Timeout-ul de citire apare ca ResourceAccessException.
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
spring.http.client.read-timeout=500ms
*/
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(RestClient.Builder builder) {
this.http = builder.baseUrl("http://localhost:8081").build();
}
Stoc stoc(String cod) {
try {
return http.get().uri("/stoc/{cod}", cod).retrieve().body(Stoc.class);
} catch (ResourceAccessException e) {
return new Stoc(cod, -1);
}
}
}
@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
Timeout-ul de 500 ms a funcționat corect: nu a lăsat magazinul să aștepte 2 secunde. Problema era că depășirea, raportată ca ResourceAccessException, nu era tratată. Acum clientul primește imediat un răspuns cu bucati = -1 (stoc necunoscut), iar interfața poate afișa „stoc indisponibil momentan”.
Alte forme ale mesajului
org.springframework.web.client.ResourceAccessException: I/O error on GET request for "http://localhost:8081/stoc/A1": Read timed outjava.net.SocketTimeoutException: Read timed outfeign.RetryableException: Read timed out executing GET
Cum o eviți pe viitor
- Configurează explicit connect timeout și read timeout pentru fiecare client.
- Alege valorile după timpii reali de răspuns măsurați, cu o marjă.
- Tratează depășirea: 503, valoare de rezervă, circuit breaker.
- Monitorizează latența serviciilor apelate (Actuator, Micrometer) și ajustează timeout-urile când se schimbă.
Întrebări frecvente
Merită să reîncerc după un timeout?
Doar pentru operații idempotente și cu backoff. Un serviciu supraîncărcat poate fi încetinit și mai mult de reîncercări.
Care e diferența dintre connect timeout și read timeout?
Connect timeout limitează deschiderea conexiunii; read timeout limitează așteptarea datelor după ce conexiunea s-a deschis.
Erori înrudite
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ă. CallNotPermittedException: CircuitBreaker 'stoc' is OPEN and does not permit further calls Circuit breaker-ul Resilience4j a văzut prea multe apeluri eșuate către serviciu și s-a deschis: blochează apelurile pentru o perioadă și aruncă CallNotPermittedException. Este comportamentul dorit. Ce lipsește de obicei e o metodă fallback care să răspundă cât timp circuitul e deschis. HttpServerErrorException$InternalServerError: 500 Internal Server Error: "{"status":500,"error":"Internal Server Error","path":"/stoc/A1"}" Serviciul apelat a răspuns cu o eroare 5xx, iar RestClient/RestTemplate aruncă HttpServerErrorException. Problema e în celălalt serviciu, dar neprinsă îți strică și răspunsul tău (500). Prinde excepția, răspunde cu 503 sau cu o valoare de rezervă, și investighează jurnalul serviciului apelat. Î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.
