Spring Boot Zuul Authorization Header拦截器技术实现问询

针对你这个基于Zuul网关的授权头拦截需求，我们可以利用Zuul自带的Filter机制来实现，这是Zuul处理请求拦截的标准方式，比普通Spring MVC拦截器更适配网关场景。下面是具体的实现步骤和代码示例：

1. 自定义Zuul授权过滤器 #

创建一个继承ZuulFilter的类，实现请求前置拦截、授权头校验逻辑：

import com.netflix.zuul.ZuulFilter;
import com.netflix.zuul.context.RequestContext;
import com.netflix.zuul.exception.ZuulException;
import org.springframework.http.HttpStatus;
import org.springframework.stereotype.Component;
import javax.servlet.http.HttpServletRequest;

@Component
public class AuthorizationFilter extends ZuulFilter {

    // 指定过滤器类型：pre表示在路由到目标服务前执行
    @Override
    public String filterType() {
        return "pre";
    }

    // 过滤器执行优先级，数字越小优先级越高
    @Override
    public int filterOrder() {
        return 1;
    }

    // 判断是否需要执行该过滤器（这里我们设置为总是执行）
    @Override
    public boolean shouldFilter() {
        return true;
    }

    // 核心的拦截逻辑：处理Authorization头校验
    @Override
    public Object run() throws ZuulException {
        RequestContext ctx = RequestContext.getCurrentContext();
        HttpServletRequest request = ctx.getRequest();

        // 从请求头中获取Authorization字段
        String authorizationHeader = request.getHeader("Authorization");

        // 这里编写你的授权校验逻辑，比如校验token有效性、权限等
        if (authorizationHeader == null || !isValidAuthorization(authorizationHeader)) {
            // 如果校验不通过，阻止请求继续路由到目标服务
            ctx.setSendZuulResponse(false);
            // 设置响应状态码为401 Unauthorized
            ctx.setResponseStatusCode(HttpStatus.UNAUTHORIZED.value());
            // 可以添加自定义响应信息
            ctx.setResponseBody("{\"error\":\"Invalid or missing Authorization header\"}");
            ctx.getResponse().setContentType("application/json");
        }

        return null;
    }

    // 这里是你的授权校验逻辑示例，根据实际业务实现
    private boolean isValidAuthorization(String authHeader) {
        // 比如校验JWT token、OAuth2令牌等，这里模拟简单校验
        return authHeader.startsWith("Bearer ") && authHeader.length() > 7;
    }
}

2. 整合到你的Spring Boot应用 #

因为我们给AuthorizationFilter添加了@Component注解，Spring会自动扫描并注册这个过滤器，不需要额外在Application.java中做配置。当然你也可以选择在Application类中手动注册Bean：

@EnableZuulProxy 
@SpringBootApplication 
@EnableSwagger2 
public class Application { 
    public static void main(String[] args) { 
        SpringApplication.run(Application.class, args); 
    } 

    @Bean 
    UiConfiguration uiConfig() { 
        return new UiConfiguration("validatorUrl", "list", "alpha", "schema", UiConfiguration.Constants.DEFAULT_SUBMIT_METHODS, false, true, 60000L); 
    }

    // 如果没有给AuthorizationFilter加@Component，可以在这里注册
    @Bean
    public AuthorizationFilter authorizationFilter() {
        return new AuthorizationFilter();
    }
}

关键说明 #

• filterType：设置为pre意味着这个过滤器会在请求路由到后端服务之前执行，正好适合做授权校验。
• shouldFilter：你可以根据业务需求调整这个方法的返回值，比如只对特定路径的请求执行校验。
• 授权校验逻辑：isValidAuthorization方法是示例，你需要替换成实际的业务逻辑，比如调用认证服务校验token、解析JWT获取用户权限等。
• 错误处理：当校验不通过时，我们通过setSendZuulResponse(false)阻止请求继续转发，并设置401状态码和自定义响应体，给客户端明确的错误提示。

这样，所有通过该Zuul网关的请求都会被这个过滤器拦截，校验Authorization头的有效性，只有校验通过的请求才会被路由到目标服务。

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