Unable to find GatewayFilterFactory with name StripPrefixx
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,
CircuitBreakercere Resilience4j,RequestRateLimitercere 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
spring.cloud.gateway.routes[0].filters[0]=StripPrefixx=1spring.cloud.gateway.routes[0].filters[0]=StripPrefix=1Numele e cel al clasei fără sufixul GatewayFilterFactory.
2Filtru propriu cu nume nepotrivit
@Component
class AdaugaAntet extends AbstractGatewayFilterFactory<Object> { ... }
# filters[0]=AdaugaAntet@Component
class AdaugaAntetGatewayFilterFactory extends AbstractGatewayFilterFactory<Object> { ... }
# filters[0]=AdaugaAntetSufixul GatewayFilterFactory e cel care face legătura cu numele din configurație.
3Dependență lipsă
filters[0]=CircuitBreaker=stoc<artifactId>spring-cloud-starter-circuitbreaker-reactor-resilience4j</artifactId>Unele filtre există doar cu dependența lor pe classpath.
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.
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);
}
}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.
Reparația
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]=StripPrefix=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);
}
}De ce merge
Numele filtrelor din configurație corespund claselor ...GatewayFilterFactory, iar StripPrefixx nu există, deci ruta nu putea fi construită. Cu StripPrefix=1, gateway-ul elimină segmentul /api și trimite /stoc/A1 către serviciul de pe portul 8081, care răspunde cu stocul. Rutele încărcate efectiv se pot verifica oricând prin /actuator/gateway/routes.
Alte forme ale mesajului
java.lang.IllegalArgumentException: Unable to find GatewayFilterFactory with name StripPrefixxjava.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
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ă. 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. 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. Î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.
