Spring Cloud Gateway网关WebSocket配置实战：从基础路由到跨域难题解析

1. 为什么需要网关处理WebSocket？

在微服务架构中，网关作为所有服务的统一入口，承担着请求路由、负载均衡、安全认证等重要职责。WebSocket作为一种全双工通信协议，在实时消息推送、在线聊天、协同编辑等场景中广泛应用。但很多开发者第一次在Spring Cloud Gateway中配置WebSocket转发时，往往会遇到连接立即断开、跨域报错等"坑"。

我去年在开发一个在线教育平台时，就遇到过这样的问题：前端通过WebSocket连接网关，但握手成功后连接瞬间断开，控制台抛出UnsupportedOperationException异常。经过排查发现，这其实是由于网关的跨域处理方式与WebSocket协议不兼容导致的。本文将带你从零开始，一步步解决这些典型问题。

2. WebSocket基础路由配置

2.1 路由配置核心概念

Spring Cloud Gateway的核心配置围绕三个关键概念展开：

• Route（路由）：定义请求如何转发到后端服务，包含唯一ID、目标URI、断言(Predicate)和过滤器(Filter)
• Predicate（断言）：匹配HTTP请求的条件，比如路径、Header、参数等
• Filter（过滤器）：在请求转发前后对请求和响应进行处理

对于WebSocket转发，最基础的配置如下：

yaml复制spring:
  cloud:
    gateway:
      routes:
        - id: websocket_route
          uri: ws://localhost:8080 
          predicates:
            - Path=/ws/**

这个配置表示所有以/ws开头的请求都会被转发到本地的8080端口WebSocket服务。

2.2 负载均衡配置

在实际生产环境中，WebSocket服务通常会部署多个实例。这时可以通过服务发现和负载均衡来实现高可用：

yaml复制spring:
  cloud:
    gateway:
      routes:
        - id: websocket_lb
          uri: lb:ws://websocket-service
          predicates:
            - Path=/ws/**

这里的lb:ws://前缀表示通过负载均衡器访问名为websocket-service的服务。Gateway会从注册中心（如Nacos、Eureka）获取服务实例列表，并采用轮询等策略进行负载均衡。

2.3 权重路由实战

在某些场景下，我们可能需要将流量按比例分配到不同版本的