Spring Cloud Gateway如何配置同一路径同时支持HTTP与WebSocket？

可以实现，而且不需要为WebSocket单独配置路由，Spring Cloud Gateway本身支持自动处理WebSocket的协议升级请求，只要后端服务支持WebSocket即可。

你的现有配置问题分析 #

你尝试添加的ws路由其实是多余的，甚至可能带来潜在问题：

• Spring Cloud Gateway的路由是按配置顺序匹配的，第一个http路由没有设置predicates，会匹配所有请求，包括/graphql的HTTP请求，所以这类请求会正常被转发到http://kubernetes-ingres-controller。
• 对于WebSocket升级请求（带有Upgrade: websocket和Connection: Upgrade头），即使没有单独的ws路由，Gateway也会自动识别并将请求转发为ws://kubernetes-ingres-controller（如果配置的uri是http协议），无需额外配置。

最佳配置方案 #

只需要保留单一路由即可覆盖所有HTTP和WebSocket请求，不需要逐个枚举路径：

spring:
  cloud:
    gateway:
      routes:
      - id: all_traffic
        uri: http://kubernetes-ingres-controller
        predicates:
          - Path=/**
        filters:
          # 保留你原有的请求头处理、Cookie转Bearer令牌等过滤器
          # 比如：- AddRequestHeader=X-Custom-Header, value
          #      - YourCookieToBearerFilter

关键原理说明 #

Spring Cloud Gateway会自动识别请求中的Upgrade头：

• 当请求携带Upgrade: websocket时，Gateway会自动将http://的uri转换为ws://，将https://转换为wss://，完成协议升级并转发到后端。
• 常规HTTP请求则保持原协议转发，完全不影响原有业务逻辑。

注意事项 #

1. 确保后端的Kubernetes Ingress Controller支持WebSocket协议（大部分主流Ingress Controller如NGINX Ingress都支持，可能需要开启对应配置）。
2. 如果使用自定义过滤器，需确保过滤器不会拦截或修改WebSocket升级请求的关键头（如Upgrade、Connection、Sec-WebSocket-Key等），避免破坏协议升级流程。

内容的提问来源于stack exchange，提问作者David North