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

HttpClientErrorException$NotFound: 404 Not Found: "{"status":404,"error":"Not Found","path":"/stoc/Z9"}"

Pe scurt

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.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Implicit, RestClient și RestTemplate consideră orice răspuns 4xx o eroare și aruncă HttpClientErrorException (cu subclase: $NotFound, $BadRequest, $Unauthorized...). Mesajul conține codul, textul și corpul răspunsului: 404 Not Found: "{...}", sau 404 Not Found: [no body] dacă serviciul nu a trimis corp.

Două situații complet diferite produc același mesaj:

  • URL greșit: calea apelată nu există în serviciul țintă (un prefix lipsă, /stocuri în loc de /stoc). Corpul răspunsului arată de obicei No static resource sau calea;
  • resursa nu există: calea e corectă, dar codul cerut nu e în baza celuilalt serviciu. E un caz normal de business, pe care trebuie să-l tratezi.

În al doilea caz, prinde excepția (sau folosește onStatus) și traduce-o într-un răspuns potrivit pentru clientul tău, de obicei tot 404, cu un mesaj clar. Altfel, o simplă resursă lipsă devine 500.

De ce apare: cauzele frecvente

1Resursa lipsă nu e tratată

Greșit
JAVA
Stoc s = 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 (HttpClientErrorException.NotFound e) {
    throw new ResponseStatusException(HttpStatus.NOT_FOUND, "Produsul " + cod + " nu există în stoc");
}

Traduci eroarea serviciului extern într-un 404 al serviciului tău.

2Tratare cu onStatus

Greșit
JAVA
.retrieve().body(Stoc.class);
Corect
JAVA
.retrieve()
.onStatus(s -> s.value() == 404, (req, res) -> {
    throw new ProdusNegasitException(cod);
})
.body(Stoc.class);

onStatus îți permite să arunci propria excepție pentru un anumit cod.

3Calea apelată e greșită

Greșit
JAVA
.uri("/stocuri/{cod}", cod)
Corect
JAVA
.uri("/stoc/{cod}", cod)

Calea trebuie să corespundă exact rutei din serviciul țintă.

Repară tu

Repară eroarea, direct în pagină

Pentru un cod inexistent, serviciul de stoc răspunde 404, iar magazinul dă 500 cu HttpClientErrorException$NotFound: 404 Not Found. Prinde excepția în StocClient și răspunde clientului cu 404 și mesajul Produsul Z9 nu există în stoc.

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/Z9/stoc → 404
{"status":404,"error":"Not Found","message":"Produsul Z9 nu există în stoc","path":"/produse/Z9/stoc"}
Indiciu

Prinde HttpClientErrorException.NotFound și aruncă un ResponseStatusException cu NOT_FOUND.

Alte forme ale mesajului

  • 404 Not Found: [no body]
  • org.springframework.web.client.HttpClientErrorException$BadRequest: 400 Bad Request: "{...}"
  • org.springframework.web.client.HttpClientErrorException$Unauthorized: 401 Unauthorized: [no body]

Cum o eviți pe viitor

  • Decide pentru fiecare apel ce înseamnă 404 (resursă lipsă sau bug) și tratează-l explicit.
  • Folosește onStatus sau un ResponseErrorHandler comun pentru toți clienții.
  • Jurnalizează corpul răspunsului de eroare: conține de obicei motivul.
  • Scrie un test pentru apelul cu o resursă inexistentă.

Întrebări frecvente

Pot face RestClient să nu arunce excepții la 4xx?

Da: .onStatus(s -> true, (req, res) -> {}) sau toEntity(...) combinat cu un handler care nu aruncă. Atunci verifici singur getStatusCode().

Cum citesc corpul erorii din excepție?

Cu e.getResponseBodyAsString() sau e.getResponseBodyAs(ProblemDetail.class) (Spring 6).

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.