Spring Cloud Gateway

Spring Cloud Gateway es el equivalente reactivo de YARP: predicados eligen la ruta, filtros transforman el intercambio y una URI decide el destino.

Una ruta de borde estrecha

El gateway expone /api/scales/**, elimina /api y añade una cabecera rastreable:

@Bean
RouteLocator courseRoutes(RouteLocatorBuilder routes,
                          @Value("${course.scales-uri}") String scalesUri) {
    return routes.routes()
            .route("scales", route -> route.path("/api/scales/**")
                    .filters(filters -> filters.stripPrefix(1)
                            .addRequestHeader("X-Course", "spring-cloud-gateway"))
                    .uri(scalesUri))
            .build();
}

La ruta contiene políticas de transporte, no decisiones musicales. Autenticación, límites y correlación son asuntos del borde; construir acordes no. Cada filtro cambia los fallos posibles: mantén la cadena corta y observable.

Una prueba real sin servicio externo

La prueba liga ambos procesos a puertos asignados por el sistema. Un upstream Reactor Netty devuelve ruta y cabecera; el gateway arranca con @SpringBootTest y recibe la URI mediante @DynamicPropertySource.

upstream = HttpServer.create().port(0)
        .route(routes -> routes.get("/scales/C", (request, response) -> response
                .sendString(Mono.just(request.uri() + "|"
                        + request.requestHeaders().get("X-Course")))))
        .bindNow();

GET /api/scales/C -> /scales/C|spring-cloud-gateway
GET /other        -> 404

mvn -B -pl l06-gateway -am test

Esto cubre predicado, orden de filtros, reenvío y ruta no encontrada. No demuestra latencia productiva, TLS ni confianza en cabeceras proxy.

Ejercicios

Añade /api/progressions/** preservando el camino tras eliminar /api.

Solución

Añade una ruta con ID distinto, path("/api/progressions/**") y stripPrefix(1). Prueba la URI del upstream, no el objeto route.

Añade a la respuesta el ID de la ruta elegida.

Solución

Usa addResponseHeader("X-Route", "scales") y WebTestClient.expectHeader(). No expongas nombres internos.

¿Por qué no aplicar retry automáticamente a toda petición?

Solución

Puede duplicar efectos no idempotentes y multiplicar carga durante un fallo. Limita método, error e intentos y mide la amplificación. La lección 9 añade resiliencia deliberadamente.

Spring Cloud Gateway

Una ruta de borde estrecha

Una prueba real sin servicio externo

Ejercicios

Fuentes