如何配置GKE多集群HTTPRoute超时以维持WebSocket连接

你遇到的核心问题是GKE Gateway Controller会自动同步K8s资源到GCP的Backend Service，直接用gcloud修改Backend Service会被控制器覆盖，必须通过K8s自定义资源来持久化配置超时。以下是具体解决方案：

1. 使用BackendPolicy配置持久化超时 #

GKE的Gateway Controller通过networking.gke.io/v1beta1组的BackendPolicy CRD来管理后端服务的超时、负载均衡等策略，这是官方支持的持久化配置方式，不会被自动覆盖。

创建BackendPolicy示例 #

在你的第二集群中，针对Spring Boot服务所在的命名空间创建如下资源：

apiVersion: networking.gke.io/v1beta1
kind: BackendPolicy
metadata:
  name: websocket-long-timeout
  namespace: your-service-namespace  # 替换为服务所在命名空间
spec:
  # 配置超时时间，这里设置为1天（86400秒）
  default:
    timeout:
      sec: 86400
  # 关联目标服务（二选一：targetRef指定单个服务，或selector匹配多个服务）
  targetRef:
    group: ""
    kind: Service
    name: your-spring-boot-service  # 替换为你的服务名称
  # 若需批量配置多个服务，可替换为selector：
  # selector:
  #   matchLabels:
  #     app: spring-boot-api  # 替换为你的服务标签

2. 验证配置生效 #

• 应用BackendPolicy后，等待1-2分钟让Gateway Controller同步配置
• 通过gcloud compute backend-services describe <backend-service-name>检查超时设置，确认已更新为86400秒
• 测试WebSocket连接，观察是否不再出现30秒超时断开的问题

3. 额外：确保WebSocket升级配置正确 #

虽然你提到跨集群通信正常，但为了避免WebSocket握手问题，建议在HTTPRoute中添加请求头修改规则，确保Upgrade协议被正确传递：

apiVersion: gateway.networking.k8s.io/v1beta1
kind: HTTPRoute
metadata:
  name: your-websocket-route
  namespace: your-service-namespace
spec:
  parentRefs:
  - name: your-gateway-name
    namespace: gateway-namespace  # Gateway所在命名空间
  hostnames:
  - "your-dns-domain.com"
  rules:
  - matches:
    - path:
        type: PathPrefix
        value: /ws  # 替换为你的WebSocket路径
    filters:
    - type: RequestHeaderModifier
      requestHeaderModifier:
        set:
        - name: Connection
          value: Upgrade
        - name: Upgrade
          value: websocket
    backendRefs:
    - name: your-spring-boot-service
      port: 8080

关键注意事项 #

• 确保你的GKE集群使用的是支持BackendPolicy的Gateway Controller版本（GKE 1.21+ 版本默认支持）
• 不要直接修改GCP Backend Service的配置，所有规则必须通过K8s资源定义，避免被控制器覆盖
• 如果存在多个BackendPolicy，targetRef指定的单个服务策略优先级高于selector匹配的批量策略

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