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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Pentru răspunsurile 5xx, clienții HTTP din Spring aruncă HttpServerErrorException (subclase $InternalServerError, $BadGateway, $ServiceUnavailable, $GatewayTimeout). Mesajul conține codul și corpul: 500 Internal Server Error: "{...}".
O eroare 5xx înseamnă că serviciul țintă a avut o problemă: o excepție neprinsă, baza lui de date căzută, o dependență indisponibilă. Cauza nu se repară în codul clientului; o găsești în jurnalul acelui serviciu, la ora cererii (un id de corelare, traceId, ajută enorm).
Ce ține de serviciul tău este reacția: o eroare 500 de la o dependență nu trebuie să devină automat 500 pentru clientul tău. Poți răspunde cu 503 și un mesaj clar, poți folosi o valoare de rezervă (stoc „necunoscut”), poți reîncerca dacă operația e idempotentă (@Retryable) sau poți proteja apelul cu un circuit breaker, ca să nu insiști asupra unui serviciu care pică.
De ce apare: cauzele frecvente
1Eroarea dependenței 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 (HttpServerErrorException e) {
throw new ResponseStatusException(HttpStatus.SERVICE_UNAVAILABLE, "Stocul nu poate fi verificat acum");
}Clientul tău primește 503, un cod care spune corect că problema e temporară și externă.
2Valoare de rezervă cu circuit breaker
Stoc stoc(String cod) { ... }@CircuitBreaker(name = "stoc", fallbackMethod = "rezerva")
Stoc stoc(String cod) { ... }
Stoc rezerva(String cod, Throwable t) { return new Stoc(cod, -1); }Fallback-ul răspunde imediat cât timp serviciul e căzut.
Repară eroarea, direct în pagină
Când serviciul de stoc răspunde 500, magazinul dă tot 500 cu HttpServerErrorException$InternalServerError. Prinde excepția în StocClient și răspunde cu 503 și mesajul Stocul nu poate fi verificat acum.
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);
}
}
}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}
GET /produse/A1/stoc → 503
{"status":503,"error":"Service Unavailable","message":"Stocul nu poate fi verificat acum","path":"/produse/A1/stoc"}Indiciu
Prinde HttpServerErrorException și aruncă ResponseStatusException cu SERVICE_UNAVAILABLE.
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) {
try {
return http.get().uri("/stoc/{cod}", cod).retrieve().body(Stoc.class);
} catch (HttpServerErrorException e) {
throw new ResponseStatusException(HttpStatus.SERVICE_UNAVAILABLE, "Stocul nu poate fi verificat acum");
}
}
}
@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
Eroarea 500 venea din serviciul de stoc, nu din magazin, dar neprinsă devenea tot 500. Acum magazinul răspunde 503, care spune corect clientului că o dependență e temporar indisponibilă și că poate reîncerca mai târziu. Prima cerere, când stocul funcționa, întoarce în continuare datele.
Alte forme ale mesajului
org.springframework.web.client.HttpServerErrorException$ServiceUnavailable: 503 Service Unavailable: [no body]org.springframework.web.client.HttpServerErrorException$BadGateway: 502 Bad Gateway: [no body]feign.FeignException$InternalServerError: [500 Internal Server Error] during [GET]
Cum o eviți pe viitor
- Tratează explicit erorile 5xx ale fiecărei dependențe: 503, valoare de rezervă sau retry.
- Reîncearcă doar operațiile idempotente (GET, PUT), nu un POST care creează comenzi.
- Folosește circuit breaker pentru dependențele instabile.
- Propagă un id de corelare (
traceId) ca să găsești eroarea în jurnalul serviciului apelat.
Întrebări frecvente
De ce nu repar eroarea în serviciul meu?
Pentru că ea vine din celălalt serviciu. Al tău trebuie doar să reacționeze corect; cauza se repară acolo, după jurnal.
Ce diferență e între 502, 503 și 504?
502: gateway-ul a primit un răspuns invalid; 503: serviciul e temporar indisponibil; 504: gateway-ul nu a primit răspuns la timp.
Erori înrudite
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. 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. 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. Î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.
