如何基于请求主机实现Spring Zuul动态路由（解决路径冲突）

嘿，这个场景我太熟悉了——之前帮团队迁移Apache反向代理到Zuul的时候也遇到过一模一样的问题。Zuul默认是按路径匹配路由，所以同路径的规则会冲突，但确实可以通过自定义组件来实现基于请求Host的路由逻辑，给你两种经过实践验证的方案：

方案一：自定义RouteLocator（推荐全局场景） #

Zuul的路由匹配核心是RouteLocator接口，我们可以继承默认的SimpleRouteLocator，重写路由查找逻辑，把请求的Host头作为路由判断的依据：

步骤1：实现自定义HostBasedRouteLocator #

import org.springframework.cloud.netflix.zuul.filters.SimpleRouteLocator;
import org.springframework.cloud.netflix.zuul.filters.ZuulProperties;
import org.springframework.http.HttpHeaders;
import org.springframework.stereotype.Component;
import javax.servlet.http.HttpServletRequest;

@Component
public class HostBasedRouteLocator extends SimpleRouteLocator {

    public HostBasedRouteLocator(String servletPath, ZuulProperties properties) {
        super(servletPath, properties);
    }

    @Override
    protected ZuulProperties.ZuulRoute lookupRoute(String path) {
        HttpServletRequest request = getCurrentRequest();
        String hostHeader = request.getHeader(HttpHeaders.HOST);
        if (hostHeader == null) {
            // 无Host头时走默认路由逻辑
            return super.lookupRoute(path);
        }
        // 处理带端口的Host（比如app1.mydomain.com:8080）
        String host = hostHeader.split(":")[0];

        // 根据Host匹配对应路由
        ZuulProperties.ZuulRoute targetRoute = null;
        switch (host) {
            case "app1.mydomain.com":
                targetRoute = this.getRoute("app1");
                break;
            case "app2.mydomain.com":
                targetRoute = this.getRoute("app2");
                break;
            default:
                // 匹配不到Host时走默认路径路由
                targetRoute = super.lookupRoute(path);
        }

        return targetRoute != null ? targetRoute : super.lookupRoute(path);
    }
}

步骤2：保留原有路由配置 #

你的application.yml可以继续保留两个冲突路径的配置，因为自定义的RouteLocator会根据Host来选择对应的路由，不会再出现冲突：

zuul:
  routes:
    app1:
      path: /path/conflict/**
      url: https://microservice1.mydomain.com/
    app2:
      path: /path/conflict/**
      url: https://microservice2.mydomain.com/

方案二：使用Pre过滤器（适合局部路径场景） #

如果只需要针对特定路径做Host路由，用Zuul的Pre过滤器更灵活——在路由匹配前修改请求的路由标识，让Zuul匹配到对应的规则：

实现HostBasedRoutingFilter #

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

@Component
public class HostBasedRoutingFilter extends ZuulFilter {

    @Override
    public String filterType() {
        return "pre"; // 路由匹配前执行
    }

    @Override
    public int filterOrder() {
        return 1; // 优先级高于默认路由过滤器
    }

    @Override
    public boolean shouldFilter() {
        // 只对目标路径生效，避免全局拦截
        HttpServletRequest request = RequestContext.getCurrentContext().getRequest();
        return request.getRequestURI().startsWith("/path/conflict/");
    }

    @Override
    public Object run() {
        RequestContext ctx = RequestContext.getCurrentContext();
        HttpServletRequest request = ctx.getRequest();
        String hostHeader = request.getHeader(HttpHeaders.HOST);
        if (hostHeader == null) {
            return null;
        }
        String host = hostHeader.split(":")[0];

        // 根据Host指定对应的路由服务ID
        if ("app1.mydomain.com".equals(host)) {
            ctx.put("serviceId", "app1");
        } else if ("app2.mydomain.com".equals(host)) {
            ctx.put("serviceId", "app2");
        }
        return null;
    }
}

注意事项 #

• 如果你的微服务是注册到服务发现组件（比如Eureka）的，可以把配置里的url换成serviceId，这样Zuul会自动从注册中心获取服务地址，更灵活。
• 要考虑Host头的兼容性，比如有些客户端可能会发送带端口的Host，所以记得用split(":")[0]提取纯主机名。
• 如果需要更复杂的Host匹配规则（比如通配符），可以把Host和路由的映射关系放到配置文件里，避免硬编码。

内容的提问来源于stack exchange，提问作者JJ Zabkar