Какая основная роль Spring Cloud Gateway?

Задачи шлюза:

• маршрутизация — /api/orders/** → сервис заказов, /api/users/** → пользователи; по заголовкам — канареечные версии;
• аутентификация на входе — проверка JWT один раз, передача пользователя сервисам в заголовке;
• ограничение частоты — RequestRateLimiter с Redis;
• устойчивость — таймауты, повторы, circuit breaker на маршрут;
• преобразования — переписывание путей, добавление заголовков, CORS;
• наблюдаемость — единая точка метрик и трассировки входящего трафика.

Устройство: маршрут состоит из предикатов (Path, Host, Method, Header, Weight) и цепочки фильтров. Адрес — URL или lb://orders (через service discovery и клиентскую балансировку).

Реализация: исходный Gateway работает на WebFlux (Netty) — неблокирующий, держит много соединений. С 2023 года есть Gateway Server MVC на сервлетном стеке.

Чего не делать: бизнес-логику и агрегацию данных в шлюзе — он общий для всех команд и превращается в монолит на входе. Для агрегации под клиента — отдельный BFF.

Выбор: если весь стек на Spring и нужна гибкая логика на Java — Spring Cloud Gateway; если нужна максимальная производительность и инфраструктурное управление — Envoy, nginx, ingress-контроллер.

spring.cloud.gateway.routes:
  - id: orders
    uri: lb://orders
    predicates: [Path=/api/orders/**]
    filters:
      - StripPrefix=1
      - name: CircuitBreaker
        args: { name: orders, fallbackUri: forward:/fallback/orders }