微服务02

2026 年 4 月 24 日

3915 字

13 分钟

SpringCloud

微服务:网关及配置管理

基于 微服务02.pptx 整理的 Markdown 讲义版笔记。

本文对原始 PPT 内容做了结构化重组与适度润色,便于系统学习、复习与二次修改。


目录


一、为什么需要网关

在微服务架构中,系统通常包含多个后端服务,例如:

  • 用户服务
  • 商品服务
  • 订单服务
  • 支付服务

如果前端直接访问这些服务,会遇到很多问题:

  • 服务地址多,前端接入复杂
  • 不同服务的认证逻辑难以统一
  • 请求路由分散,不方便管理
  • 负载均衡与服务发现需要统一处理

因此需要一个统一入口:网关(Gateway)。

网关的定义

网关就是网络的关口,负责:

  • 请求路由
  • 请求转发
  • 身份校验
  • 负载均衡
  • 统一处理跨域、日志、限流等能力

一句话理解

网关是所有客户端访问微服务集群的统一入口。


二、Spring Cloud Gateway 简介

在 Spring Cloud 生态中,网关主要有两种实现:

组件特点
Spring Cloud GatewaySpring 官方出品,基于 WebFlux,响应式编程,性能好
Netflix ZuulNetflix 出品,基于 Servlet,阻塞式编程,需要更多性能调优

推荐选择

课程中重点使用的是:

  • Spring Cloud Gateway

因为它:

  • 和 Spring Cloud 集成度高
  • 支持响应式编程
  • 默认性能较好
  • 更适合新项目

三、网关路由快速入门

1. 网关的基本工作流程

flowchart LR
    A[前端请求] --> B[Gateway 网关]
    B --> C[Nacos 注册中心]
    C --> B
    B --> D[item-service]
    B --> E[user-service]
    B --> F[trade-service]

网关接收到请求后会:

  1. 根据路由规则判断请求该去哪个服务
  2. 从注册中心拉取目标服务实例
  3. 通过负载均衡选择一个实例
  4. 将请求转发过去

2. 快速入门步骤

PPT 中给出的网关搭建步骤可以总结为:

  1. 创建新的 gateway 模块
  2. 引入网关依赖
  3. 编写启动类
  4. 配置路由规则

3. 引入依赖

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

4. 路由配置示例

spring:
  cloud:
    gateway:
      routes:
        - id: item
          uri: lb://item-service
          predicates:
            - Path=/items/**
        - id: user
          uri: lb://user-service
          predicates:
            - Path=/users/**

5. 关键字段说明

字段说明
id路由唯一标识
uri路由目标地址,lb:// 表示基于服务名负载均衡
predicates路由断言,用于判断请求是否符合当前路由
filters路由过滤器,用于对请求或响应做进一步处理

6. 示例说明

当访问:

http://127.0.0.1:8080/items/list

如果命中:

- Path=/items/**

则网关会将请求转发到:

lb://item-service

然后结合 Nacos 拉取实例列表并选择一个实例完成调用。


四、路由断言与过滤器

Spring Cloud Gateway 中,路由的核心是:

  • 断言(Predicates):决定“这个请求该不该走这条路由”
  • 过滤器(Filters):决定“请求在转发前后要做什么处理”

1. 常见断言

Spring 提供了多种 RoutePredicateFactory 实现,常见如下:

名称说明示例
After某时间点之后生效After=2037-01-20T17:42:47.789-07:00[America/Denver]
Before某时间点之前生效Before=2031-04-13T15:14:47.433+08:00[Asia/Shanghai]
Between某时间区间内生效Between=t1,t2
Cookie必须包含指定 CookieCookie=chocolate,ch.p
Header必须包含指定请求头Header=X-Request-Id, \d+
Host匹配指定域名Host=**.somehost.org
Method匹配请求方式Method=GET,POST
Path匹配请求路径Path=/items/**
Query匹配查询参数Query=name,Jack
RemoteAddr匹配来源 IPRemoteAddr=192.168.1.1/24
Weight权重路由Weight=group1,2
XForwardedRemoteAddr根据转发来源 IP 匹配XForwardedRemoteAddr=192.168.1.1/24

2. 常见过滤器

网关内置了大量过滤器,常用如下:

名称说明示例
AddRequestHeader添加请求头AddRequestHeader=name,value
RemoveRequestHeader删除请求头RemoveRequestHeader=name
AddResponseHeader添加响应头AddResponseHeader=name,value
RemoveResponseHeader删除响应头RemoveResponseHeader=name
RewritePath重写请求路径RewritePath=/red/?(?<segment>.*), /${segment}
StripPrefix去除路径前缀StripPrefix=1

3. 典型用途

  • 统一增加请求头
  • 去掉前端访问路径中的公共前缀
  • 规范化后端路径
  • 在转发前后做额外逻辑处理

五、网关登录校验

1. 为什么在网关做登录校验?

如果每个微服务都单独处理登录校验:

  • 代码重复
  • 维护成本高
  • 安全策略难统一

因此更合理的方式是:

在网关转发前统一做 JWT 登录校验。

2. 网关请求处理流程

Spring Cloud Gateway 的请求处理流程可以概括为:

  1. HandlerMapping 根据请求匹配路由
  2. 将匹配结果放入上下文
  3. 请求交给 WebHandler
  4. FilteringWebHandler 组织过滤器链
  5. 顺序执行各过滤器的 pre 逻辑
  6. 请求被转发到微服务
  7. 响应返回后,倒序执行各过滤器的 post 逻辑

3. 关键点

  • 所有 pre 逻辑通过,请求才会被转发
  • 某个过滤器拦截后,后续过滤器不再继续执行
  • 响应回来后,会再执行 post 逻辑

4. 流程图

flowchart TD
    A[客户端请求] --> B[RoutePredicateHandlerMapping]
    B --> C[FilteringWebHandler]
    C --> D[Filter 1 pre]
    D --> E[Filter 2 pre]
    E --> F[NettyRoutingFilter 转发请求]
    F --> G[微服务]
    G --> H[Filter 2 post]
    H --> I[Filter 1 post]
    I --> J[响应客户端]

六、自定义过滤器

网关中有两类过滤器:

类型说明
GatewayFilter路由过滤器,只作用于指定路由,需要配置后才生效
GlobalFilter全局过滤器,对所有路由生效,声明后自动生效

它们的核心过滤方法签名一致:

Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain);

其中:

  • exchange:请求上下文,包含 request、response 等共享数据
  • chain:过滤器链,用于放行到下一个过滤器

1. 自定义 GlobalFilter

如果要作用于所有请求,最简单的方式是实现 GlobalFilter。

@Component
public class MyGlobalFilter implements GlobalFilter, Ordered {

    @Override
    public Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) {
        System.out.println("GlobalFilter pre阶段 执行了。");
        return chain.filter(exchange)
                .then(Mono.fromRunnable(() -> {
                    System.out.println("post阶段 执行了。");
                }));
    }

    @Override
    public int getOrder() {
        return 0;
    }
}

2. 执行顺序

  • 值越小,优先级越高
  • pre 按顺序执行
  • post 按倒序执行

3. 自定义 GatewayFilter

如果只想对某一类路由生效,则通常实现:

  • AbstractGatewayFilterFactory

示意结构如下:

@Component
public class PrintAnyGatewayFilterFactory
        extends AbstractGatewayFilterFactory<PrintAnyGatewayFilterFactory.Config> {

    public PrintAnyGatewayFilterFactory() {
        super(Config.class);
    }

    @Override
    public GatewayFilter apply(Config config) {
        return (exchange, chain) -> {
            System.out.println("PrintAny filter 执行了");
            return chain.filter(exchange);
        };
    }

    @Data
    public static class Config {
        private String a;
        private String b;
        private String c;
    }

    @Override
    public List<String> shortcutFieldOrder() {
        return List.of("a", "b", "c");
    }
}

对应配置示例:

spring:
  cloud:
    gateway:
      default-filters:
        - PrintAny=1,2,3

七、网关传递用户信息

登录校验只发生在网关还不够,因为:

  • 网关知道当前登录用户是谁
  • 但下游微服务也可能需要用户信息处理业务

例如:

  • 查询购物车
  • 创建订单
  • 清理购物车
  • 更新用户相关业务

解决思路

在网关登录校验成功后,将用户信息写入请求头,再转发给下游微服务。

示例代码

exchange.mutate()
    .request(builder -> builder.header("user-info", userInfo))
    .build();

下游处理方式

每个微服务可以通过 Spring MVC 拦截器:

  1. 从请求头获取 user-info
  2. 解析用户信息
  3. 保存到 ThreadLocal
  4. 供业务代码随时使用

推荐做法

PPT 中建议把这类拦截器统一写到 hm-common 中,这样:

  • 每个微服务只需引入依赖即可
  • 不需要重复编写相同逻辑
  • 用户上下文获取方式保持统一

八、OpenFeign 传递用户信息

微服务之间也会通过 OpenFeign 相互调用。

例如:

  • 交易服务调用商品服务扣减库存
  • 交易服务调用购物车服务清理购物车

如果此时用户信息不继续往下传,就会造成调用链丢失用户上下文。

OpenFeign 的解决方式

OpenFeign 提供了 RequestInterceptor,所有由 Feign 发起的请求都会先经过它。

public interface RequestInterceptor {
    void apply(RequestTemplate template);
}

典型作用

  • 从 ThreadLocal 中取出当前用户信息
  • 写入 Feign 请求头
  • 让下游服务继续拿到用户身份

结果

这样就实现了:

  • 浏览器 → 网关:JWT 校验
  • 网关 → 微服务:请求头传递用户信息
  • 微服务 → 微服务:OpenFeign 拦截器继续透传用户信息

九、微服务登录整体方案

整个登录方案可以总结为下面这条链路:

flowchart LR
    A[浏览器携带 JWT 请求] --> B[Gateway GlobalFilter]
    B --> C[校验 JWT]
    C --> D[写入 user-info 请求头]
    D --> E[下游微服务 HandlerInterceptor]
    E --> F[保存用户到 ThreadLocal]
    F --> G[业务处理]
    G --> H[OpenFeign RequestInterceptor]
    H --> I[继续透传用户信息到其他微服务]

各层职责

层级组件职责
网关层GlobalFilter登录校验、用户透传
微服务入口HandlerInterceptor读取请求头中的用户信息并保存上下文
服务间调用RequestInterceptorFeign 调用时继续传递用户信息
业务层ThreadLocal随时获取当前登录用户

十、配置管理

在微服务系统中,配置会越来越多,常见问题包括:

  • 多个微服务存在大量重复配置
  • 配置变更后需要重启服务
  • 网关路由写死在本地配置中,改动不灵活

因此需要引入统一配置中心。

课程中的方案

使用 Nacos 同时承担:

  • 注册中心
  • 配置管理中心

配置中心的价值

  • 统一管理共享配置
  • 支持配置动态推送
  • 降低维护成本
  • 支持配置热更新
  • 支持网关动态路由

十一、配置共享

1. 共享配置的目的

把多个服务共用的配置抽取到 Nacos 中统一管理,例如:

  • JDBC 配置
  • MyBatis Plus 配置
  • 日志配置
  • Swagger 配置
  • OpenFeign 配置

这样每个微服务就不需要重复维护这些内容。


2. 引入依赖

<!-- nacos 配置管理 -->
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
</dependency>

<!-- 读取 bootstrap 文件 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-bootstrap</artifactId>
</dependency>

3. 为什么使用 bootstrap.yml

因为 Spring Cloud 上下文初始化比普通 application.yml 更早, 要在应用启动早期就从 Nacos 拉配置,因此需要使用 bootstrap.yml。

4. bootstrap.yaml 示例

spring:
  application:
    name: cart-service
  profiles:
    active: dev
  cloud:
    nacos:
      server-addr: 192.168.150.101:8848
      config:
        file-extension: yaml
        shared-configs:
          - dataId: shared-jdbc.yaml
          - dataId: shared-log.yaml
          - dataId: shared-swagger.yaml

5. 配置加载过程

可以概括为:

  1. 先加载 bootstrap.yml
  2. 根据配置去 Nacos 拉取远程配置
  3. 将远程配置与本地配置合并
  4. 初始化应用上下文

十二、配置热更新

1. 什么是配置热更新?

配置热更新指的是:

修改配置后,无需重启微服务,新的配置即可生效。

2. 典型应用场景

PPT 中的示例是:

  • 购物车允许添加的商品上限原本写死在代码中
  • 现在改为从配置中读取
  • 并由 Nacos 统一管理,实现动态修改

3. 前提条件

要实现热更新,需要满足两个条件:

条件一:Nacos 中存在该服务对应的配置文件

配置文件 dataId 的命名通常与以下信息有关:

  • spring.application.name
  • spring.profiles.active(可选)
  • file-extension

条件二:项目中以支持刷新的方式读取配置

常见方式有两种。

方式一:@ConfigurationProperties
@Data
@ConfigurationProperties(prefix = "hm.cart")
public class CartProperties {
    private int maxItems;
}
方式二:@RefreshScope + @Value
@Data
@RefreshScope
public class CartProperties {

    @Value("${hm.cart.maxItems}")
    private int maxItems;
}

4. 使用建议

  • 如果是一组配置,优先 @ConfigurationProperties
  • 如果是单个配置快速接入,@Value 也可用
  • 热更新场景要注意配置变更后的业务影响

十三、动态路由

1. 为什么需要动态路由?

如果网关路由写死在本地配置文件中,那么:

  • 每次修改都要重启网关
  • 新增服务或变更路径不够灵活
  • 运维成本高

因此更好的做法是:

把路由配置存储到 Nacos 中,并在配置变化时实时更新网关路由表。


2. 实现动态路由的两件事

PPT 中总结得很清楚,需要完成两件事:

  1. 监听 Nacos 配置变更消息
  2. 在配置变更时更新网关路由表

3. 监听 Nacos 配置

可以通过 NacosConfigManager 注册监听器:

private final NacosConfigManager nacosConfigManager;

public void initRouteConfigListener() throws NacosException {
    String configInfo = nacosConfigManager
        .getConfigService()
        .getConfigAndSignListener(dataId, group, 5000, new Listener() {
            @Override
            public Executor getExecutor() {
                return null;
            }

            @Override
            public void receiveConfigInfo(String configInfo) {
                // 监听到配置变化后,更新路由
            }
        });

    // 首次启动时,也要主动加载一次配置
}

4. 更新路由表

网关中可以使用 RouteDefinitionWriter 更新路由:

public interface RouteDefinitionWriter {
    Mono<Void> save(Mono<RouteDefinition> route);
    Mono<Void> delete(Mono<String> routeId);
}

常见操作

  • save(...):新增或覆盖路由
  • delete(...):根据路由 id 删除路由

5. 推荐使用 JSON 维护路由配置

PPT 推荐在 Nacos 中使用 json 格式保存动态路由,因为更方便解析。

示例:

{
  "id": "item",
  "uri": "lb://item-service",
  "predicates": [
    {
      "name": "Path",
      "args": {
        "_genkey_0": "/items/**",
        "_genkey_1": "/search/**"
      }
    }
  ],
  "filters": []
}

对应的 YAML 写法大致是:

spring:
  cloud:
    gateway:
      routes:
        - id: item
          uri: lb://item-service
          predicates:
            - Path=/items/**,/search/**

6. 动态路由整体流程

flowchart TD
    A[Nacos 中维护路由配置] --> B[Gateway 启动时首次加载]
    A --> C[Nacos 配置变更通知]
    C --> D[监听器收到新配置]
    D --> E[解析为 RouteDefinition]
    E --> F[RouteDefinitionWriter 更新路由表]
    F --> G[网关立即使用新路由]

十四、本章总结

1. 网关的核心作用是什么?

  • 统一入口
  • 请求路由
  • 请求转发
  • 身份校验
  • 负载均衡

2. 网关为什么重要?

因为它让前端不必直接面对多个微服务,并把公共逻辑统一收口处理。

3. 路由由什么组成?

  • id
  • uri
  • predicates
  • filters

4. 登录校验为什么放到网关?

  • 统一认证逻辑
  • 减少服务重复开发
  • 更利于统一安全控制

5. 用户信息如何在调用链上传递?

  • 网关通过过滤器把用户信息写入请求头
  • 微服务通过拦截器读取并保存到 ThreadLocal
  • OpenFeign 通过 RequestInterceptor 继续透传用户信息

6. 为什么要做配置中心?

  • 降低重复配置维护成本
  • 支持配置热更新
  • 支持动态路由

7. 配置热更新的关键是什么?

  • Nacos 中存在服务对应配置
  • 代码中以支持刷新的方式读取配置

8. 动态路由的关键是什么?

  • 监听配置中心的路由变更
  • 变更后实时更新网关路由表

附:本章知识主线

flowchart LR
    A[Gateway 网关] --> B[路由]
    A --> C[过滤器]
    C --> D[JWT 登录校验]
    D --> E[用户信息透传]
    E --> F[OpenFeign 透传]
    A --> G[Nacos 配置中心]
    G --> H[配置共享]
    G --> I[配置热更新]
    G --> J[动态路由]

适合复习时记住的三句话

  1. 网关是微服务系统的统一入口,负责路由、转发和鉴权。
  2. 登录校验放在网关,用户信息通过请求头和 Feign 拦截器层层透传。
  3. Nacos 不仅能做注册中心,还能做配置中心和动态路由中心。
微服务02
https://blog.yagami.top/blog/springcloud/1微服务/微服务02/
作者
Nekode
发布时间
2026 年 4 月 24 日
许可协议
CC BY-NC-SA 4.0

正在加载评论...

目录

输入关键词开始搜索