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.
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 obiceiNo static resourcesau 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ă
Stoc s = http.get().uri("/stoc/{cod}", cod).retrieve().body(Stoc.class);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
.retrieve().body(Stoc.class);.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ă
.uri("/stocuri/{cod}", cod).uri("/stoc/{cod}", cod)Calea trebuie să corespundă exact rutei din serviciul țintă.
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.
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/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.
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 (HttpClientErrorException.NotFound e) {
throw new ResponseStatusException(HttpStatus.NOT_FOUND, "Produsul " + cod + " nu există în stoc");
}
}
}
@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
RestClient transforma răspunsul 404 al serviciului de stoc în HttpClientErrorException, iar excepția neprinsă devenea 500 în magazin. Acum StocClient prinde exact cazul NotFound și îl traduce într-un 404 al magazinului, cu un mesaj pentru client. Codul A1 merge ca înainte, iar alte erori (500, timeout) nu sunt ascunse.
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
onStatussau unResponseErrorHandlercomun 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
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. 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ă. FeignException$NotFound: [404 Not Found] during [GET] to [http://localhost:8081/stoc/Z9] [StocClient#stoc(String)] Clientul Feign a primit 404 de la serviciul apelat și, implicit, aruncă FeignException$NotFound. Neprinsă, devine 500 în serviciul tău. Verifică ruta din interfața @FeignClient și tratează resursa lipsă: prinde excepția, folosește dismiss404 sau un ErrorDecoder propriu. Î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.
