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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
OpenFeign generează implementarea interfeței @FeignClient. Pentru orice răspuns cu cod de eroare, decoderul implicit aruncă o subclasă de FeignException: $NotFound pentru 404, $BadRequest pentru 400, $InternalServerError pentru 500. Mesajul spune tot: codul, metoda, URL-ul exact, metoda din interfață (StocClient#stoc(String)) și corpul răspunsului.
Ca la RestClient, 404 poate însemna două lucruri:
- ruta din interfață e greșită:
@GetMapping("/stocuri/{cod}")în loc de/stoc/{cod}, sau lipsește un prefix dinurl/path. Compară URL-ul din mesaj cu ruta serviciului; - resursa nu există: caz de business. Prinde
FeignException.NotFoundși răspunde cu 404 sau foloseștedismiss404 = trueîn@FeignClient, ca metoda să întoarcănullsauOptional.empty().
Pentru o tratare uniformă a tuturor erorilor unui client, scrie un ErrorDecoder care transformă codurile în excepțiile aplicației tale.
De ce apare: cauzele frecvente
1Resursa lipsă nu e tratată
return stoc.stoc(cod);try {
return stoc.stoc(cod);
} catch (FeignException.NotFound e) {
throw new ResponseStatusException(HttpStatus.NOT_FOUND, "Produsul " + cod + " nu există în stoc");
}Traduci 404-ul serviciului extern în 404-ul serviciului tău.
2Ruta din interfață nu corespunde
@GetMapping("/stocuri/{cod}")
Stoc stoc(@PathVariable("cod") String cod);@GetMapping("/stoc/{cod}")
Stoc stoc(@PathVariable("cod") String cod);Ruta din interfață trebuie să fie identică cu cea din controllerul serviciului apelat.
3Lipsă dismiss404
@FeignClient(name = "stoc")@FeignClient(name = "stoc", dismiss404 = true)
// metoda întoarce Optional<Stoc>Cu dismiss404, 404 nu mai aruncă excepție.
Repară eroarea, direct în pagină
Magazinul cheamă serviciul de stoc prin Feign. Pentru un cod inexistent, primește 500 cu FeignException$NotFound: [404 Not Found] during [GET]. Prinde excepția în ProdusController și răspunde 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.*;
import org.springframework.cloud.openfeign.*;
import feign.FeignException;
/* 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
@EnableFeignClients
class MagazinApp {
public static void main(String[] args) {
SpringApplication.run(MagazinApp.class, args);
}
@FeignClient(name = "stoc", url = "http://localhost:8081")
interface StocClient {
@GetMapping("/stoc/{cod}")
Stoc stoc(@PathVariable("cod") String cod);
}
@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
Excepția se prinde ca FeignException.NotFound; răspunsul se dă cu ResponseStatusException.
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.*;
import org.springframework.cloud.openfeign.*;
import feign.FeignException;
/* 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
@EnableFeignClients
class MagazinApp {
public static void main(String[] args) {
SpringApplication.run(MagazinApp.class, args);
}
@FeignClient(name = "stoc", url = "http://localhost:8081")
interface StocClient {
@GetMapping("/stoc/{cod}")
Stoc stoc(@PathVariable("cod") String cod);
}
@RestController
static class ProdusController {
private final StocClient stoc;
ProdusController(StocClient stoc) {
this.stoc = stoc;
}
@GetMapping("/produse/{cod}/stoc")
Stoc stoc(@PathVariable String cod) {
try {
return stoc.stoc(cod);
} catch (FeignException.NotFound e) {
throw new ResponseStatusException(HttpStatus.NOT_FOUND, "Produsul " + cod + " nu există în stoc");
}
}
}
}De ce merge
Decoderul implicit al Feign transforma 404-ul serviciului de stoc în FeignException$NotFound, iar excepția neprinsă devenea 500 în magazin. Acum controllerul prinde exact cazul NotFound și răspunde cu 404, cu un mesaj pentru client. Codul A1 funcționează ca înainte, iar celelalte erori nu sunt ascunse.
Alte forme ale mesajului
feign.FeignException$NotFound: [404] during [GET] to [http://stoc/stoc/Z9] [StocClient#stoc(String)]: []feign.FeignException$BadRequest: [400 Bad Request] during [POST] to [...]feign.FeignException$InternalServerError: [500 Internal Server Error] during [GET] to [...]
Cum o eviți pe viitor
- Ține rutele interfețelor Feign aliniate cu controllerele (contracte comune sau OpenAPI).
- Tratează 404 explicit:
try/catch,dismiss404sau unErrorDecoder. - Folosește un
ErrorDecodercomun pentru a traduce codurile în excepțiile aplicației. - Testează clientul cu WireMock, inclusiv pentru resurse inexistente.
Întrebări frecvente
Unde văd ce a răspuns serviciul?
În ultima paranteză din mesaj (corpul răspunsului) sau cu e.contentUTF8(). Pentru detalii, pune logging.level.<pachet>.StocClient=DEBUG și spring.cloud.openfeign.client.config.default.logger-level=full.
E mai bine Feign sau RestClient?
Feign e declarativ și comod când ai multe apeluri. RestClient nu are nevoie de Spring Cloud. Tratarea erorilor e asemănătoare.
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. No instances available for stocc Load balancer-ul a primit un nume de serviciu, dar registrul de servicii nu are nicio instanță pornită cu acel nume. Fie numele din URL e scris greșit, fie serviciul nu s-a înregistrat (nu rulează, alt spring.application.name, alt registru). Compară numele cu cel din Eureka. 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. Î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.
