Spring Cloud Gateway自定义谓词失败时如何设置自定义响应状态码

问题1：谓词中直接设置响应状态码的方式是否正确？ #

不正确。
原因是Spring Cloud Gateway的路由匹配规则是：只有当某条路由的所有谓词全部返回true时，该路由才会被命中，后续才会执行该路由绑定的过滤器、转发逻辑。如果谓词返回false，Gateway会直接跳过当前路由，继续匹配下一条路由，所有路由都匹配失败时，会走全局404逻辑，你在未命中路由的谓词中设置的状态码会被后续匹配流程覆盖，自然不会生效。

问题2：谓词失败时是否有办法触发对应路由的过滤器？ #

不行。
路由绑定的过滤器只会在当前路由被成功命中（所有谓词返回true）后才会执行，谓词匹配失败的路由不会触发任何属于它的过滤器逻辑。

正确实现方案 #

你应该把鉴权逻辑从谓词迁移到路由专属过滤器中，这也是Spring Cloud Gateway做权限校验的标准实现方式，代码如下：

1. 自定义鉴权过滤器工厂

@Component
public class AuthenticationGatewayFilterFactory extends AbstractGatewayFilterFactory<AuthenticationGatewayFilterFactory.Config> {

    public AuthenticationGatewayFilterFactory() {
        super(Config.class);
    }

    @Override
    public GatewayFilter apply(Config config) {
        return (exchange, chain) -> {
            try {
                Boolean isRequestAuthenticated = checkAuthenticated();
                if (isRequestAuthenticated) {
                    // 认证通过，继续后续流程
                    return chain.filter(exchange);
                }
                // 认证失败直接返回403
                exchange.getResponse().setStatusCode(HttpStatus.FORBIDDEN);
                return exchange.getResponse().setComplete();
            } catch (HttpClientErrorException e) {
                exchange.getResponse().setStatusCode(HttpStatus.FORBIDDEN);
                return exchange.getResponse().setComplete();
            }
        };
    }

    private Boolean checkAuthenticated() {
        // 原有鉴权逻辑不变，发起REST调用判断权限
        return true;
    }

    public static class Config {
        // 可扩展自定义配置参数
    }
}

2. 修改路由配置，绑定过滤器

@Bean
public RouteLocator customRoutesLocator(RouteLocatorBuilder builder, AuthenticationGatewayFilterFactory authFilter) {
    return builder.routes()
            .route("id1", r -> r.path("/app1/**")
                    // 绑定鉴权过滤器
                    .filters(f -> f.filter(authFilter.apply(new AuthenticationGatewayFilterFactory.Config())))
                    .uri("lb://id1"))
            .build();
}

这个方案下，路径匹配成功后才会执行鉴权逻辑，认证失败直接返回403，不会走到后续404流程，符合你的需求。

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