如何配置Zuul API网关将其生成的JWT令牌转发至目标微服务

嘿，这个问题我刚好处理过好几次，给你梳理下具体的配置步骤和注意点，确保Zuul能把它生成的JWT正确转发到下游微服务：

Zuul作为网关，在生成JWT令牌后，需要通过**前置过滤器（Pre Filter）**把令牌注入到请求头中，再将请求路由到对应的微服务。关键是要保证令牌能被正确添加到转发的请求头里，同时避免被Zuul的默认规则过滤掉。

1. 实现Zuul前置过滤器 #

创建一个自定义的Pre过滤器，在路由请求到微服务之前，把生成好的JWT添加到请求头中。这里假设你已经有了JWT生成的逻辑（比如用Spring Security OAuth2或自定义工具类）：

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

@Component
public class JwtForwardFilter extends ZuulFilter {

    @Override
    public String filterType() {
        return "pre"; // 标记为前置过滤器，在路由执行前触发
    }

    @Override
    public int filterOrder() {
        return 10; // 执行顺序，确保在默认的前置过滤器之后运行
    }

    @Override
    public boolean shouldFilter() {
        // 可自定义过滤规则，比如只对/api开头的请求转发JWT
        RequestContext ctx = RequestContext.getCurrentContext();
        HttpServletRequest request = ctx.getRequest();
        return request.getRequestURI().startsWith("/api/");
    }

    @Override
    public Object run() {
        RequestContext ctx = RequestContext.getCurrentContext();
        HttpServletRequest request = ctx.getRequest();

        // 替换成你实际获取生成好的JWT的逻辑
        // 比如从Security上下文、会话或自定义缓存中拿令牌
        String jwtToken = getGeneratedJwtToken();

        if (jwtToken != null) {
            // 按标准格式添加到Authorization头
            ctx.addZuulRequestHeader("Authorization", "Bearer " + jwtToken);
        }
        return null;
    }

    // 模拟获取JWT的方法，实际项目替换为你的业务逻辑
    private String getGeneratedJwtToken() {
        // 示例：从Spring Security上下文获取令牌
        // return SecurityContextHolder.getContext().getAuthentication().getCredentials().toString();
        return "your-actual-generated-jwt-token";
    }
}

2. 配置Zuul路由规则 #

在application.yml或application.properties中配置路由，确保请求能正确转发到目标微服务：

zuul:
  routes:
    user-service:
      path: /api/user/**
      url: http://localhost:8081/user-service
    order-service:
      path: /api/order/**
      url: http://localhost:8082/order-service

3. 关闭Authorization头的敏感过滤 #

Zuul默认会把Authorization、Cookie等头标记为敏感头，不进行转发。所以需要修改配置，允许转发Authorization头：

zuul:
  sensitive-headers: Cookie,Set-Cookie # 移除Authorization，这样就会转发该头

也可以针对单个路由单独配置：

zuul:
  routes:
    user-service:
      path: /api/user/**
      url: http://localhost:8081/user-service
      sensitive-headers: Cookie,Set-Cookie # 仅对该路由关闭指定敏感头

4. 下游微服务适配 #

确保你的微服务能识别并解析Authorization头中的JWT。比如在微服务中配置Spring Security的JWT认证过滤器，验证令牌的签名和有效性。

• 用Postman或curl请求Zuul网关的接口，比如GET http://zuul-host:8080/api/user/1
• 在下游微服务的日志中打印请求头，确认Authorization头是否包含正确的JWT
• 或者在微服务中编写接口，返回当前请求的Authorization头内容，直接验证令牌是否传递成功

• 不要漏掉Bearer 前缀：下游服务通常依赖这个标准格式解析JWT，少了会导致验证失败
• 过滤器的shouldFilter()逻辑要准确：避免漏掉需要转发令牌的请求路径，或者错误过滤了不需要的请求
• 注意过滤器执行顺序：确保你的JWT转发过滤器在其他可能修改请求头的过滤器之后运行

内容的提问来源于stack exchange，提问作者MK-rou