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

Unable to find GatewayFilterFactory with name StripPrefixx

Pe scurt

O rută din Spring Cloud Gateway folosește un filtru al cărui nume nu există: o greșeală de scriere (StripPrefixx), un filtru dintr-o dependență lipsă sau un filtru propriu înregistrat cu alt nume. Gateway-ul nu poate construi ruta. Corectează numele din filters.

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

Ce înseamnă

IllegalArgumentException: Unable to find GatewayFilterFactory with name StripPrefixx apare când Spring Cloud Gateway construiește rutele din configurație. Fiecare filtru scris ca Nume=argumente este căutat printre bean-urile GatewayFilterFactory, după numele clasei fără sufixul GatewayFilterFactory: StripPrefixGatewayFilterFactory devine StripPrefix, AddRequestHeaderGatewayFilterFactory devine AddRequestHeader.

Cauze:

  • greșeală de scriere sau de majuscule: StripPrefixx, stripPrefix;
  • filtrul vine dintr-o dependență care lipsește (de exemplu, CircuitBreaker cere Resilience4j, RequestRateLimiter cere Redis);
  • un filtru propriu, a cărui clasă nu respectă convenția de nume sau nu e bean (@Component).

La fel, Unable to find RoutePredicateFactory with name ... înseamnă un predicat scris greșit (Pathh=). Mesajul apare la prima încărcare a rutelor, iar ruta respectivă nu funcționează.

De ce apare: cauzele frecvente

1Nume de filtru scris greșit

Greșit
JAVA
spring.cloud.gateway.routes[0].filters[0]=StripPrefixx=1
Corect
JAVA
spring.cloud.gateway.routes[0].filters[0]=StripPrefix=1

Numele e cel al clasei fără sufixul GatewayFilterFactory.

2Filtru propriu cu nume nepotrivit

Greșit
JAVA
@Component
class AdaugaAntet extends AbstractGatewayFilterFactory<Object> { ... }
# filters[0]=AdaugaAntet
Corect
JAVA
@Component
class AdaugaAntetGatewayFilterFactory extends AbstractGatewayFilterFactory<Object> { ... }
# filters[0]=AdaugaAntet

Sufixul GatewayFilterFactory e cel care face legătura cu numele din configurație.

3Dependență lipsă

Greșit
JAVA
filters[0]=CircuitBreaker=stoc
Corect
JAVA
<artifactId>spring-cloud-starter-circuitbreaker-reactor-resilience4j</artifactId>

Unele filtre există doar cu dependența lor pe classpath.

Repară tu

Repară eroarea, direct în pagină

Gateway-ul ar trebui să trimită /api/stoc/A1 către serviciul de stoc, fără prefixul /api, dar cererea dă 404. În proiectul real, jurnalul arată Unable to find GatewayFilterFactory with name StripPrefixx. Corectează numele filtrului din GatewayApp.properties.

Codul care dă eroarea
JAVA
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;

/* GatewayApp.properties
server.port=8080
spring.cloud.gateway.routes[0].id=stoc
spring.cloud.gateway.routes[0].uri=http://localhost:8081
spring.cloud.gateway.routes[0].predicates[0]=Path=/api/stoc/**
spring.cloud.gateway.routes[0].filters[0]=StripPrefixx=1
*/
/* StocApp.properties
server.port=8081
*/

@SpringBootApplication
class StocApp {
    public static void main(String[] args) {
        SpringApplication.run(StocApp.class, args);
    }

    @RestController
    static class StocController {
        @GetMapping("/stoc/{cod}")
        Stoc stoc(@PathVariable String cod) {
            return new Stoc(cod, 5);
        }
    }
}

record Stoc(String cod, int bucati) { }

@SpringBootApplication
class GatewayApp {
    public static void main(String[] args) {
        SpringApplication.run(GatewayApp.class, args);
    }
}
După reparație, programul afișează
Tomcat started on port 8081 (http)
Started StocApp
Tomcat started on port 8080 (http)
Started GatewayApp
GET /api/stoc/A1 → 200
{"cod":"A1","bucati":5}
Indiciu

Filtrul care elimină segmente din cale se numește StripPrefix.

Alte forme ale mesajului

  • java.lang.IllegalArgumentException: Unable to find GatewayFilterFactory with name StripPrefixx
  • java.lang.IllegalArgumentException: Unable to find RoutePredicateFactory with name Pathh

Cum o eviți pe viitor

  • Copiază numele filtrelor din documentația Spring Cloud Gateway, nu din memorie.
  • Verifică rutele încărcate cu Actuator (/actuator/gateway/routes).
  • Scrie un test care pornește gateway-ul și apelează fiecare rută.
  • Pentru filtre proprii, respectă sufixul GatewayFilterFactory și înregistrează-le ca bean.

Întrebări frecvente

Ce face StripPrefix=1?

Elimină primul segment din cale înainte de redirecționare: /api/stoc/A1 ajunge la serviciu ca /stoc/A1.

De ce primesc 404 în loc de eroare la pornire?

Depinde de versiune și de momentul încărcării rutelor: dacă ruta nu poate fi construită, gateway-ul nu o are, deci cererile pe acea cale nu se potrivesc cu nicio rută.

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.