Zuul路由配置与过滤器的深度解析

### Zuul路由配置与过滤器的深度解析 #### 1. 手动使用服务发现映射路由 在Zuul中，除了依赖服务的Eureka服务ID创建的自动路由，还可以通过显式定义路由映射来实现更细粒度的控制。例如，若要简化组织服务的路由，可在`zuulsvr/src/main/resources/application.yml`文件中手动定义路由映射。 ```yaml zuul: routes: organizationservice: /organization/** ``` 添加此配置后，就可以通过`/organization/v1/organizations/{organization-id}`路由访问组织服务。此时，Zuul服务器的路由表会有两个与组织服务相关的条目： - 手动定义的映射：`“organization/**”: “organizationservice”` - 基于Eureka服务ID的自动映射：`“/organizationservice/**”: “organizationservice”` 需要注意的是，使用自动路由映射时，如果服务没有运行实例，Zuul不会暴露该服务的路由；而手动映射路由时，即使Eureka中没有注册该服务的实例，Zuul仍会显示该路由，若尝试调用不存在的服务路由，Zuul将返回500错误。 若要排除基于Eureka服务ID的自动映射，仅保留手动定义的组织服务路由，可在`application.yml`文件中添加`ignored-services`参数： ```yaml zuul: ignored-services: 'organizationservice' routes: organizationservice: /organization/** ``` `ignored-services`属性允许定义一个以逗号分隔的Eureka服务ID列表，用于排除自动注册。若要排除所有基于Eureka的路由，可将`ignored-services`属性设置为`“*”`。 服务网关常见的模式是通过为所有服务调用添加前缀（如`/api`）来区分API路由和内容路由。Zuul支持通过`prefix`属性实现此功能，示例配置如下： ```yaml zuul: ignored-services: '*' prefix: /api routes: organizationservice: /organization/** licensingservice: /licensing/** ``` 配置完成并重新加载Zuul服务后，访问`/routes`端点，将看到`/api/organization`和`/api/licensing`两条路由。 #### 2. 使用静态URL手动映射路由 Zuul还可用于路由未由Eureka管理的服务，可将其配置为直接路由到静态定义的URL。例如，若许可证服务是用Python编写的，希望通过Zuul代理该服务，可使用以下配置： ```yaml zuul: routes: licensestatic: path: /licensestatic/** url: http://licenseservice-static:8081 ``` 配置更改后，访问`/routes`端点，可看到静态路由已添加到Zuul。但绕过Eureka后，只有一个路由指向请求，可手动配置Zuul禁用Ribbon与Eureka的集成，并列出Ribbon进行负载均衡的各个服务实例，配置如下： ```yaml zuul: routes: licensestatic: path: /licensestatic/** serviceId: licensestatic ribbon: eureka: enabled: false licensestatic: ribbon: listOfServers: http://licenseservice-static1:8081, http://licenseservice-static2:8082 ``` 此配置中，`/api/licensestatic`路由将映射到名为`licensestatic`的服务ID。 不过，静态映射路由并禁用Ribbon与Eureka的集成会带来问题，即Zuul无法使用Ribbon缓存服务查找信息，会给Eureka服务器带来更多负载。对于非JVM应用，可设置单独的Zuul服务器处理这些路由，也可设置Spring Cloud “Sidecar”实例，将非JVM服务注册到Eureka并通过Zuul代理。 #### 3. 动态重新加载路由配置 动态重新加载路由的能力非常有用，可在不重启Zuul服务器的情况下更改路由映射。可使用Spring Cloud配置将Zuul路由外部化，在`config-repo`中创建`zuulservice`文件夹，并创建`zuulservice.yml`、`zuulservice-dev.yml`和`zuulservice-prod.yml`三个文件来保存路由配置。 初始路由配置示例： ```plaintext zuul.prefix=/api ``` 若要动态添加新的路由映射，只需修改配置文件并提交到Spring Cloud Config拉取配置数据的Git仓库。例如，若要禁用所有基于Eureka的服务注册，仅暴露组织和许可证服务的两条路由，可修改`zuulservice-*.yml`文件如下： ```plaintext zuul.ignored-services: '*' zuul.prefix: /api zuul.routes.organizationservice: /organization/** zuul.routes.organizationservice: /licensing/** ``` 提交更改到GitHub后，访问Zuul的`/refresh`端点，Zuul将重新加载路由配置。再次访问`