Gateway路由下，如何配置拦截未授权请求并跳转到登录页login？

Question

在Spring Cloud Gateway中，如何配置拦截未授权请求并跳转到登录页？ 在实际项目中，我们常需要对未授权的请求进行拦截，并重定向到登录页面。可以通过自定义GlobalFilter实现这一需求。首先，在pom.xml中引入Spring Security依赖。然后创建一个过滤器类，继承GatewayFilter并重写filter方法。在方法内，通过exchange.getRequest().getPath()获取当前请求路径，判断用户是否已登录（可通过Session或Token验证）。如果未登录，则使用ServerResponse.redirect(URI.create("login_url"))实现跳转。最后将该过滤器注册到配置类中，并确保其优先级高于其他路由规则。这种方式既保证了系统的安全性，又提升了用户体验。需要注意的是，确保登录页面的路由不被拦截，避免陷入死循环。

Answer 1

Spring Cloud Gateway中配置拦截未授权请求并跳转到登录页

在实际项目中，我们常需要对未授权的请求进行拦截，并重定向到登录页面。以下是实现这一需求的详细步骤和注意事项。

1. 项目依赖引入

首先，在pom.xml中引入Spring Security依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-security</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-gateway</artifactId>
</dependency>

确保项目的构建文件中包含上述依赖项，这是实现安全控制的基础。

2. 创建自定义过滤器类

创建一个过滤器类，继承GatewayFilter并重写filter方法：

@Component
public class AuthFilter implements GlobalFilter {
    @Override
    public Mono filter(ServerWebExchange exchange, GatewayFilterChain chain) {
        ServerHttpRequest request = exchange.getRequest();
        String path = request.getPath().value();

        // 判断是否为登录页面或静态资源
        if (path.startsWith("/login") || path.startsWith("/static")) {
            return chain.filter(exchange);
        }

        // 验证用户是否已登录（可通过Session或Token验证）
        String token = request.getHeaders().getFirst("Authorization");
        if (token == null || !isValidToken(token)) {
            // 如果未登录，则重定向到登录页面
            URI loginUri = URI.create("/login");
            ServerHttpResponse response = exchange.getResponse();
            response.setStatusCode(HttpStatus.FOUND);
            response.getHeaders().set(HttpHeaders.LOCATION, loginUri.toString());
            return response.setComplete();
        }

        return chain.filter(exchange);
    }

    private boolean isValidToken(String token) {
        // 实现Token验证逻辑
        return false;
    }
}

通过exchange.getRequest().getPath()获取当前请求路径，并判断用户是否已登录。

3. 注册过滤器并设置优先级

将自定义过滤器注册到配置类中，并确保其优先级高于其他路由规则：

@Configuration
public class GatewayConfig {
    @Bean
    public GlobalFilter authFilter() {
        return new AuthFilter();
    }
}

通过@Bean注解将过滤器注入到Spring容器中。

4. 注意事项与流程分析

以下是实现过程中需要注意的关键点：

• 确保登录页面的路由不被拦截，避免陷入死循环。
• Token验证逻辑需根据具体业务场景设计，例如JWT解析或数据库查询。
• 静态资源（如CSS、JS文件）应排除在拦截范围之外。

以下是整个流程的简化图示：

graph TD;
    A[请求到达] --> B{是否为登录页？};
    B -- 是 --> C[放行];
    B -- 否 --> D{是否已登录？};
    D -- 是 --> E[继续处理];
    D -- 否 --> F[重定向到登录页];

5. 常见问题与解决方案

以下是开发过程中可能遇到的问题及其解决方法：

问题	原因	解决方案
所有请求都被拦截，无法访问登录页	未正确排除登录页路径	在过滤器中添加路径匹配逻辑，确保登录页不被拦截
Token验证失败后未跳转到登录页	响应状态码或Header设置错误	检查response.setStatusCode和response.getHeaders().set调用
静态资源加载失败	未排除静态资源路径	在过滤器中添加静态资源路径匹配逻辑