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

HttpServerErrorException$InternalServerError: 500 Internal Server Error: "{"status":500,"error":"Internal Server Error","path":"/stoc/A1"}"

Pe scurt

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ă

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 (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

Greșit
JAVA
Stoc stoc(String cod) { ... }
Corect
JAVA
@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ă tu

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.

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
*/

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);
        }
    }
}
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":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.

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

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