在OpenShift上实现多Spring Cloud Gateway Pod的请求负载均衡

当OpenShift上的Spring Cloud Gateway扩容多个Pod后仅单个Pod处理请求，通常是Service/Route配置、会话粘滞或注册发现环节出了问题，以下是具体排查和解决步骤：

1. 检查OpenShift Service的端点关联 #

• 确认Service的标签选择器与Gateway Pod的标签完全匹配，执行oc describe service <gateway-service-name>，查看Selector字段是否和Pod的metadata.labels一致。
• 查看Service的Endpoints列表，确保所有运行中的Gateway Pod都被包含在内。如果只有一个Pod，说明未匹配到其他Pod，需修正标签或检查Pod就绪状态。
• 验证端口映射：Service的spec.ports[].targetPort必须指向Gateway监听的端口（通常是8080）。

2. 禁用会话粘滞配置 #

• 检查Gateway的配置文件，若存在spring.cloud.gateway.discovery.locator.sticky-session=true，将其改为false（默认值即为false，可直接移除该配置），该配置会强制请求绑定到同一实例。
• 排查自定义过滤器：确认没有通过Cookie、请求头或其他逻辑硬编码固定路由到某个Pod的过滤器。

3. 验证Eureka注册与发现正确性 #

• 登录Eureka控制台，确认所有Gateway Pod都已成功注册为独立实例。
• 确保Gateway配置了正确的Eureka地址：eureka.client.service-url.defaultZone=http://<eureka-service-name>:8761/eureka/。
• 开启IP优先注册：添加eureka.instance.prefer-ip-address=true，避免OpenShift内部主机名解析问题导致实例识别异常。
• 缩短实例刷新间隔：设置eureka.client.registry-fetch-interval-seconds=5，让Gateway及时获取最新的服务实例列表。

4. 修正OpenShift Route的会话亲和性 #

• 若通过Route暴露Gateway，检查Route的会话亲和性配置，执行oc describe route <gateway-route-name>查看Session Affinity字段。
• 若配置为ClientIP，会导致同一客户端请求固定到单个Pod，需修改为None：

  apiVersion: route.openshift.io/v1
  kind: Route
  metadata:
    name: gateway-route
  spec:
    sessionAffinity: None
    # 保留其他原有配置（如host、to、port等）
  

  应用修改：oc apply -f route.yaml

5. 确认负载均衡策略 #

• Spring Cloud Gateway默认使用RoundRobinLoadBalancer，若自定义了负载均衡规则，检查是否存在逻辑错误导致只选择单个实例。
• 若使用Spring Cloud LoadBalancer，确保未误启用Ribbon：添加spring.cloud.loadbalancer.ribbon.enabled=false到配置文件。

6. 检查Pod就绪状态 #

• 执行oc get pods，确认所有Gateway Pod的状态为Running且READY列显示1/1（或对应容器数）。
• 若Pod未就绪，查看日志定位问题：oc logs <pod-name>，重点检查健康检查端点（如/actuator/health）是否正常，调整livenessProbe和readinessProbe的配置，确保Pod就绪后才被加入Service端点。

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