Spring Cloud Gateway 4.1.0自定义302重定向被覆盖为200问题求助

问题分析 #

你遇到的情况是自定义全局前置过滤器设置302重定向后，实际返回状态码为200，但Location头正常返回。日志显示状态码设置成功，说明setStatusCode执行有效，但后续请求流程中状态码被覆盖。核心原因可能是：

• 过滤器优先级不足，被后续内置过滤器修改了响应状态
• 直接调用response.setComplete()未正确触发响应的完整提交逻辑，导致状态码未最终生效

解决方案 #

1. 提升过滤器优先级 #

确保自定义过滤器在所有可能修改响应的内置过滤器之前执行，通过@Order注解设置最高优先级：

@Component
@Order(Ordered.HIGHEST_PRECEDENCE)
public class LoginRedirectFilter implements GlobalFilter {
    // 你的filter方法实现
}

2. 优化响应提交逻辑 #

参考内置RedirectToGatewayFilterFactory的实现，添加Content-Length头并通过writeWith提交空响应流，确保状态码被正确写入：

public Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) {
    // 检查是否为登录请求且用户已登录的逻辑
    ServerHttpResponse response = exchange.getResponse();
    
    response.setStatusCode(HttpStatus.FOUND);
    response.getHeaders().set(HttpHeaders.LOCATION, "<你的首页URL>");
    // 添加Content-Length头，避免部分服务器/浏览器修改状态码
    response.getHeaders().set(HttpHeaders.CONTENT_LENGTH, "0");
    
    // 通过writeWith提交空流，确保响应状态码被正确生效
    return response.writeWith(Mono.empty());
}

3. 排查其他过滤器干扰 #

检查项目中是否存在其他全局过滤器或网关过滤器，尤其是涉及响应状态处理的逻辑。可以临时禁用其他自定义过滤器，验证是否是它们导致状态码被覆盖。

验证方法 #

修改后重启服务，登录后访问登录页：

• 查看浏览器开发者工具的网络请求，确认状态码为302
• 检查响应头中的Location和Content-Length是否正确

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