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

I/O error on GET request for "http://localhost:8081/stoc/A1": Read timed out

Pe scurt

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ă

Greșit
JAVA
return http.get().uri("/stoc/{cod}", cod).retrieve().body(Stoc.class);
Corect
JAVA
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ă

Greșit
JAVA
spring.http.client.read-timeout=200ms
Corect
JAVA
spring.http.client.read-timeout=2s

Timeout-ul trebuie să fie puțin peste timpul normal de răspuns, nu sub el.

3Lipsește timeout-ul cu totul

Greșit
JAVA
RestClient.create()
Corect
JAVA
RestClient.builder()
    .requestFactory(factoryCuTimeout)
    .build();

Fără timeout, un apel poate aștepta foarte mult și blochează fire de execuție.

Repară tu

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).

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.*;

/* 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);
        }
    }
}
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":-1}
Indiciu

Timeout-ul de citire apare ca ResourceAccessException.

Alte forme ale mesajului

  • org.springframework.web.client.ResourceAccessException: I/O error on GET request for "http://localhost:8081/stoc/A1": Read timed out
  • java.net.SocketTimeoutException: Read timed out
  • feign.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

← 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.