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

FeignException$NotFound: [404 Not Found] during [GET] to [http://localhost:8081/stoc/Z9] [StocClient#stoc(String)]

Pe scurt

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 din url/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ște dismiss404 = true în @FeignClient, ca metoda să întoarcă null sau Optional.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ă

Greșit
JAVA
return stoc.stoc(cod);
Corect
JAVA
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

Greșit
JAVA
@GetMapping("/stocuri/{cod}")
Stoc stoc(@PathVariable("cod") String cod);
Corect
JAVA
@GetMapping("/stoc/{cod}")
Stoc stoc(@PathVariable("cod") String cod);

Ruta din interfață trebuie să fie identică cu cea din controllerul serviciului apelat.

3Lipsă dismiss404

Greșit
JAVA
@FeignClient(name = "stoc")
Corect
JAVA
@FeignClient(name = "stoc", dismiss404 = true)
// metoda întoarce Optional<Stoc>

Cu dismiss404, 404 nu mai aruncă excepție.

Repară tu

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.

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

Excepția se prinde ca FeignException.NotFound; răspunsul se dă cu ResponseStatusException.

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, dismiss404 sau un ErrorDecoder.
  • Folosește un ErrorDecoder comun 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

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