From d83d7f33dbfdd9388c49a145381065063ee0f42c Mon Sep 17 00:00:00 2001 From: CyC2018 Date: Sat, 7 Nov 2026 17:10:28 +0800 Subject: [PATCH] =?UTF-8?q?Update=20=E5=BE=AE=E6=9C=8D=E5=8A=A1.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 调整高频标记;补充优雅停机的实测、网关过滤器的执行顺序、Gateway 2025.1 的配置前缀、Nacos 3.x 复现时的差异,以及链路追踪的依赖与采样率。 --- notes/微服务.md | 26 +++++++++++++++----------- 1 file changed, 15 insertions(+), 11 deletions(-) diff --git a/notes/微服务.md b/notes/微服务.md index f287389e..a350bd47 100644 --- a/notes/微服务.md +++ b/notes/微服务.md @@ -13,7 +13,7 @@ * [负载均衡策略](#负载均衡策略) * [实例下线后多久能感知](#实例下线后多久能感知) * [注册中心宕机](#注册中心宕机) - * [五、网关](#五网关) 🔥 + * [五、网关](#五网关) * [六、配置中心](#六配置中心) * [七、服务保护与分布式事务](#七服务保护与分布式事务) * [八、链路追踪](#八链路追踪) @@ -75,7 +75,7 @@ Spring Cloud 与 Spring Boot 的关系:Spring Boot 用来快速构建单个服 | 外部请求从哪里进入 | Spring Cloud Gateway | — | Zuul | | 下游故障时怎么保护自己 | Spring Cloud Circuit Breaker(Resilience4j) | Sentinel | Hystrix | | 跨服务的事务 | — | Seata | — | -| 一个请求经过了哪些服务 | Micrometer Tracing | — | — | +| 一个请求经过了哪些服务 | Micrometer Tracing(Micrometer 的项目,由 Spring Boot 集成) | — | — | 早期的 Spring Cloud 项目大多使用 Netflix 的组件。其中 Ribbon、Hystrix、Zuul 1、Archaius 1 在 2018 年进入维护模式,在 2020.0 版本中被移除,分别由 Spring Cloud LoadBalancer、Resilience4j、Spring Cloud Gateway 和 Spring Boot 的外部配置加 Spring Cloud Config 取代;Eureka 不在其中,仍在维护。链路追踪原来的 Spring Cloud Sleuth 不支持 Spring Boot 3,核心部分已经移到了 Micrometer Tracing。 @@ -213,7 +213,7 @@ interface InventoryClient { Map result = inventoryClient.deduct(10086, 2); ``` -注入的 inventoryClient 是 JDK 动态代理生成的对象,运行时打印它的类名为 $Proxy88。调用 deduct() 时: +注入的 inventoryClient 是 JDK 动态代理生成的对象,运行时打印它的类名为 $Proxy88(末尾的数字由 JVM 按代理类生成的顺序分配,不是固定值)。调用 deduct() 时: 1. 代理根据注解拼出 HTTP 请求 POST /inventory/deduct?skuId=10086&count=2; 2. Spring Cloud LoadBalancer 从 inventory-service 的实例列表中选出一个实例,默认轮询,连续下单 6 次依次落在 8082、8081、8082、8081、8082、8081; @@ -297,13 +297,13 @@ public class RandomConfiguration { | 停止方式 | Nacos 删除实例 | 默认配置 | 关闭负载均衡缓存,读取超时 2 秒 | | --- | --- | --- | --- | | kill -9,进程退出 | 0.6 s | 35 s 内约一半调用失败,共 83 次 | 失败 1 次 | -| 正常关闭 | 0.6 s | 33 s 内失败 77 次 | 失败 1 次 | +| 正常关闭 | 0.6 s | 前 10 s 仍正常处理,之后到 33 s 失败 54 次 | 没有失败 | | kill -STOP,进程卡住 | 23 s | 发往它的调用要等 60 s 才失败 | 每次 2 s 后失败,约 23 s 后不再调用 | 原因有两个: - 负载均衡缓存:Spring Cloud LoadBalancer 默认把实例列表缓存 35 秒,Nacos 已经删除了实例,调用方在缓存过期前仍然会选中它。Nacos 客户端会接收服务端推送的实例变化并保存在本地,所以可以关闭这层缓存(spring.cloud.loadbalancer.cache.enabled 设为 false),Spring Cloud 的文档也建议在服务发现客户端已有缓存时关闭,避免重复缓存; -- 连接没有断开:进程退出或者正常关闭时连接随之断开,Nacos 立刻删除实例;进程卡住、机器宕机或者网络中断时连接并没有断开,Nacos 要等健康检查超时才能发现,实测为 23 秒。这段时间只能靠调用方的超时和熔断尽快放弃这个实例。 +- 连接没有断开:进程退出时连接随之断开,正常关闭时应用先主动注销、10 秒后才退出,两种情况 Nacos 都立刻删除实例;进程卡住、机器宕机或者网络中断时连接并没有断开,Nacos 要等健康检查超时才能发现,实测为 23 秒。这段时间只能靠调用方的超时和熔断尽快放弃这个实例。 ### 注册中心宕机 @@ -314,7 +314,7 @@ public class RandomConfiguration { 所以注册中心宕机不会立刻影响线上的调用,但扩容和发布都无法进行,生产环境中 Nacos 要以集群方式部署。 -## 五、网关 🔥 +## 五、网关 外部请求不应该直接访问各个服务:客户端要知道每个服务的地址,每个服务也都要各自做鉴权、限流。网关是所有外部请求的统一入口,负责: @@ -337,7 +337,7 @@ spring: - StripPrefix=1 # 去掉 /api,转发为 /orders/** ``` -这是 2023.0 的写法,2025.0 起 starter 改名为 spring-cloud-starter-gateway-server-webflux,配置前缀改为 spring.cloud.gateway.server.webflux。 +这是 2023.0 的写法,2025.0 起 starter 改名为 spring-cloud-starter-gateway-server-webflux,配置前缀改为 spring.cloud.gateway.server.webflux;2025.0 中旧写法还能用并给出弃用警告,2025.1 起旧前缀不再生效,启动不报错,请求返回 404。 鉴权通常放在网关:网关校验令牌(例如 [JWT](HTTP.md#11-jwt)),取出用户 ID 放进请求首部,下游服务直接使用这个首部,不再重复校验: @@ -356,10 +356,11 @@ GlobalFilter auth() { } ``` -实测不带令牌或者令牌错误时,网关返回 401;带上正确的令牌时,订单服务收到 X-User-Id: 1024。需要注意两点: +实测不带令牌或者令牌错误时,网关返回 401;带上正确的令牌时,订单服务收到 X-User-Id: 1024。需要注意三点: - 用 set 而不是 add:客户端自己带上 X-User-Id: 1 时会被覆盖,实测订单服务收到的仍然是 1024; -- 下游服务信任网关传来的首部,所以这些服务本身不能对外暴露,只能通过网关访问。 +- 下游服务信任网关传来的首部,所以这些服务本身不能对外暴露,只能通过网关访问; +- 这个 Lambda 没有指定顺序,按最低优先级排在负载均衡之后、转发之前(Spring Cloud Gateway 4.1 实测),@Bean 方法上的 @Order 对它不起作用;需要让它在负载均衡和转发之前执行时,改为实现 Ordered 接口的类,例如 getOrder 返回 -1。 网关与 Nginx 并不冲突:Nginx 通常在最外层负责 TLS 和多个网关实例之间的负载均衡,网关在它后面按服务路由,并处理鉴权这类与业务相关的逻辑。 @@ -450,6 +451,8 @@ traceparent 是 W3C Trace Context 规定的格式,四段依次是版本、trac Apple M1 Pro,macOS 15,JDK 21,Spring Boot 3.3.5、Spring Cloud 2023.0.3、Spring Cloud Alibaba 2023.0.3.4,Nacos 2.5.4 单机模式。所有服务运行在同一台机器上:网关 8080、订单服务 8090、库存服务 8081 和 8082,启动时用 --spring.cloud.nacos.discovery.ip=127.0.0.1 注册回环地址。正文中的调用次数、耗时都来自这套环境,每次运行的数字会略有差异。 +用 Nacos 3.x 复现时有几处不同:3.3 起默认开启客户端鉴权,要先初始化管理员密码,创建业务账号并授予所需的资源权限,再给每个服务配置 spring.cloud.nacos.username 和 spring.cloud.nacos.password,否则注册失败、启动中止,A2 脚本查询 Nacos 时也要先登录取得 accessToken 并在请求中带上;3.2 起发行包不再提供 v1、v2 HTTP API,A2 中查询实例的地址要改为 /nacos/v3/client/ns/instance/list,实例列表在返回的 data 字段中;3.x 的控制台默认占用 8080 端口,网关要换一个端口。 + ### A2 实例下线 脚本先启动 8082,确认订单服务能调用到它之后,用指定的方式停止 8082;随后 60 秒内每 0.2 秒调用一次订单服务的下单接口(超时 3 秒),记下每次落在哪个端口、是否失败,同时另一个线程每 0.2 秒查询一次 Nacos,记下 8082 从实例列表中消失的时间: @@ -494,7 +497,7 @@ WARN ... FeignBlockingLoadBalancerClient : Load balancer does not contain an in ### A4 链路追踪 -库存服务中打印 traceparent 首部,某一次运行的日志如下(traceId 与正文的例子不是同一次请求): +订单服务引入 feign-micrometer(否则 OpenFeign 不传递 traceparent,库存服务会生成新的 traceId),并把 management.tracing.sampling.probability 设为 1.0(默认 0.1,未采样的请求 traceparent 末段为 00)。库存服务中打印 traceparent 首部,某一次运行的日志如下(traceId 与正文的例子不是同一次请求): ```text [inventory-service] [6ade5f4e849a3ac47ccc3cdb7dd195a0-01b064dce8abb5e0] 扣减库存 skuId=10086,traceparent=00-6ade5f4e849a3ac47ccc3cdb7dd195a0-5f83fda61e8bee64-01 @@ -504,7 +507,7 @@ traceparent 中的 traceId 与日志中的相同,第三段 5f83fda61e8bee64 ### A5 调用失败时的重试与降级 -环境同 A1,不启动 Nacos:订单服务用静态实例列表配置 inventory-service 的两个实例,一个正常运行,另一个端口没有进程监听(连接被拒绝),并关闭负载均衡缓存。@FeignClient 加上 fallback = InventoryFallback.class,InventoryFallback 实现同一接口、返回默认值,并用 @Component 注册为 Bean。分别用 GET 查询库存和 POST 扣减库存连续调用 10 次: +环境同 A1,不启动 Nacos:订单服务用静态实例列表配置 inventory-service 的两个实例,一个正常运行,另一个端口没有进程监听(连接被拒绝),并关闭负载均衡缓存。开启 openfeign.circuitbreaker 时另外引入了 spring-cloud-starter-circuitbreaker-resilience4j。@FeignClient 加上 fallback = InventoryFallback.class,InventoryFallback 实现同一接口、返回默认值,并用 @Component 注册为 Bean。分别用 GET 查询库存和 POST 扣减库存连续调用 10 次: ```text 默认依赖 GET:成功 5,失败 5(RetryableException) POST:成功 5,失败 5 @@ -522,6 +525,7 @@ traceparent 中的 traceId 与日志中的相同,第三段 5f83fda61e8bee64 - [Spring Cloud Sleuth](https://docs.spring.io/spring-cloud-sleuth/docs/current/reference/html/) - [Spring Cloud Circuit Breaker](https://docs.spring.io/spring-cloud-circuitbreaker/reference/) - [Spring Cloud Alibaba 版本说明](https://sca.aliyun.com/en/docs/2023/overview/version-explain/) +- [Spring Cloud Alibaba Releases](https://github.com/alibaba/spring-cloud-alibaba/releases) - [Understanding Eureka Client Server Communication](https://github.com/Netflix/eureka/wiki/Understanding-eureka-client-server-communication) - [Nacos: Instance Lifecycle](https://nacos.io/en/docs/latest/manual/user/naming/instance-lifecycle/) - [Nacos 2.0 兼容性文档](https://nacos.io/docs/latest/upgrading/200-compatibility/)