Spring Cloud Gateway下Controller 302重定向未跳转至网关地址问题咨询

问题根因 #

后端业务服务感知不到上层网关的存在，生成302重定向地址时默认使用自身的服务IP、端口拼接路径，而非网关的对外地址。

解决方案 #

方案1：全局转发头配置（最推荐，无业务侵入） #

通过X-Forwarded系列请求头透传网关的原始访问信息，后端服务自动基于该信息生成正确的重定向地址。

• 网关侧application.yml新增配置：

spring:
  cloud:
    gateway:
      x-forwarded:
        enabled: true
      # 若网关上层还有Nginx等反向代理，需新增以下配置
      forward-headers-strategy: native

• 所有后端业务服务application.yml新增配置：

server:
  forward-headers-strategy: framework
  # 若服务有配置context-path请同步保留

配置生效后，网关会自动将原始请求的域名、协议、端口等信息通过X-Forwarded-Host、X-Forwarded-Proto等头传递给后端服务，Spring MVC生成重定向地址时会自动读取这些头拼接正确的网关地址。

方案2：网关侧重写Location响应头（适合无法修改后端服务配置的场景） #

直接在网关层修改3xx响应的Location头，将实例地址替换为网关对外地址，无需修改任何后端服务代码或配置。
路由配置示例：

spring:
  cloud:
    gateway:
      routes:
        - id: your-service-route
          uri: lb://你的服务注册名
          predicates:
            - Path=/你的服务路由前缀/**
          filters:
            - StripPrefix=1
            # 正则可根据实际域名、路径规则调整，以下示例会把Location中域名后的路径拼接到网关地址后
            - RewriteResponseHeader=Location, ^https?://[^/]+/(.*), https://app.xxx.com/$1

方案3：代码硬编码（临时过渡用，不推荐） #

直接在Controller的重定向逻辑中写全网关的完整地址，示例：

return "redirect:https://app.xxx.com/home";

该方案耦合性高，环境切换时需要修改代码，仅适合临时应急使用。

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