Spring Cloud TSF 2021

最近更新时间:2025-09-01 10:36:22

我的收藏
基于 Spring Cloud 2021 版本 SDK,支持 Spring Boot 2.7.x。
注意:
Spring Cloud 2021 SDK 的调用链、监控功能需使用 OpenTelemetry Agent,具体使用方式请参见 Spring Cloud 2020 & 2021 SDK 使用说明

1.46.19-SpringCloud2021-RELEASE(2025-08-27)

新特性

支持配置服务名进行服务发现预热。参数为 spring.cloud.loadbalancer.eager-load.enabled(值为 boolean 类型) 和 spring.cloud.loadbalancer.eager-load.clients(多个服务时通过逗号分隔)
支持延迟注册。参数为 tsf.discovery.delayRegister(值为 boolean 类型) 和 tsf.discovery.delayRegisterInterval(单位毫秒)
TSF 服务路由/自定义路由策略支持轮询负载均衡策略。通过 tsf.loadbalancer.strategy (值为 roundRobin)设置轮询策略。
WebClient 客户端支持 TSF 服务发现及治理

优化

去除 SDK 输出的无用 agent-*.log 日志
去除无用的 commons-lang 依赖(建议使用 commons-lang3)
去除无用的 spring-boot-loader-tools 依赖

Bug 修复

升级 Tomcat 到 9.0.108,规避 CVE-2025-48989, CVE-2025-52434,CVE-2025-53506,CVE-2025-52520
升级 commons-lang3 到 3.18.0(commons-compress 升级到与 commons-lang3 对应的 1.28.0,commons-io 升级到 2.20.0) ,规避 CVE-2025-48924
升级 commons-fileload 到 1.6.0,规避 CVE-2025-48976
升级 Netty 到 4.1.124,规避 CVE-2025-55163
升级 bcpkix-jdk18on 到 1.79,规避 CVE-2025-8916
升级 commons-fileupload 到 1.6.0,规避 CVE-2025-48976
spring-cloud-tsf-security-protection-starter 增加对 CVE-2025-41235、CVE-2025-22227 的规避
修复加载空配置时可能的空指针问题
修复下游无实例时,域名路由规则失效的问题

注:使用 Tomcat 不涉及 CVE-2025-41242

1.46.18-SpringCloud2021-RELEASE(2025-06-19)

优化

支持 consul 异常时服务发现的重试时间指数回退。
网关兼容下游接口尾部包含多个/
Feign 服务预热支持 https。

Bug 修复

升级 commons-beanutils 到 1.11.0,规避 CVE-2025-48734。
升级 Tomcat 到 9.0.106,规避 CVE-2025-31650、CVE-2025-31651、CVE-2025-46701、CVE-2025-48988。
spring-cloud-tsf-security-protection-starter 增加对 CVE-2024-38820、CVE-2025-22233、CVE-2024-38828、CVE-2025-22235 的检查。
修复全局网关访问普通 ns 服务,路由失效的问题。
修复 OAuth 插件验证地址为微服务时的访问失败问题。

1.46.17-SpringCloud2021-RELEASE(2025-05-09)

新特性

适配 Feign 动态刷新配置(feign.client.refresh-enabled)。
Feign 预热支持对 FeignClient 的切面。

优化

支持配置推空保护。
触发熔断时(服务级、API 级、实例级)打印 error 日志。
触发熔断时(服务级、API 级)抛出 TsfCircuitBreakerException 异常。

Bug 修复

修复首次正常请求时会上报限流恢复事件的问题。
修复由于缓存而导致正则表达式匹配规则时可能异常的问题。

1.46.16-SpringCloud2021-RELEASE(2025-04-02)

新特性

spring-retry 场景支持治理能力。
FeignClient 注解的 configuration 中自定义 feign.Client 时,支持治理能力。

优化

网关分组校验失败,记录 error 日志。
去除无用的 mysql-connector-java 依赖版本管理,Spring Boot 2.7 推荐使用 mysql-connector-j 依赖替代。
去除无用的 rxjava 依赖。

Bug 修复

升级 Tomcat 到 9.0.102 以规避 CVE-2025-24813,升级 Netty 到 4.1.119 以规避 CVE-2025-24970。
修复限流规则匹配错误,导致重复创建令牌桶,进而影响限流精度的问题。
修复无法删除配置的问题。

1.46.15-SpringCloud2021-RELEASE(2025-02-26)

新特性

Feign 预热支持默认值。
RestTemplate 动态修改服务名时,支持服务治理功能。

优化

服务发现缓存默认有效期为 7 天,可以通过 tsf.discovery.cache.expirationTime 配置调整,单位是毫秒。

Bug 修复

修复小流量预热部分场景不生效的问题。
修复经过网关时,自定义标签丢失。
事件上报信息携带 application Id。
升级 Spring Cloud 版本到 2021.0.9。

1.46.13-SpringCloud2021-RELEASE(2025-01-25)

新特性

支持 IPv6 。
支持单元化熔断。
单元化接口支持容灾单元。

1.46.12-SpringCloud2021-RELEASE(2024-12-31)

新特性

添加路由判定开关。
支持网关自动预热加载服务。
支持 Feign 预热功能。
网关限流支持自定义返回。
支持配置关闭 Swagger 相关的对外暴露接口。(-Dtsf.swagger.doc.auto-startup=false)。
支持 Spring Cloud 原生负载均衡策略(通过 -Dtsf.loadbalancer.enabled=false 关闭 tsf 负载均衡器)。
新增 spring-cloud-tsf-security-protection-starter 依赖,需单独引用,引用后检查是否存在通过WebMvc.fn或WebFlux.fn提供静态资源,如果存在则程序退出,以规避 CVE-2024-38819、CVE-2024-38816 漏洞。
<dependency>
<groupId>com.tencent.tsf</groupId>
<artifactId>spring-cloud-tsf-security-protection-starter</artifactId>
</dependency>

Bug 修复

修复下游服务实例没有 Metadata 而导致的调用报错。
修复端口占用时进程不退出的问题。
升级 Tomcat 到 9.0.98,规避 CVE-2024-50379。

1.46.11.1-SpringCloud2021-RELEASE(2024-11-29)

Bug 修复

修复一定并发时,熔断无法恢复的问题。
单元化网关兼容 EnableTsfUnit 注解。

1.46.11-SpringCloud2021-RELEASE(2024-11-11)

新特性

支持单元化(需 TCE 平台支持):
支持异地灰度。
支持异地容灾。
GDU 支持 AZ 屏蔽的能力。

Bug 修复

升级 Spring Security 到 5.7.13,升级 Commons-IO 到 2.14.0,升级 OkHttp 到 4.12.0。

1.46.10-SpringCloud2021-RELEASE(2024-10-30)

新特性

支持异步调用的服务治理。
支持 RocketMQ 的全链路灰度发布功能。

Bug 修复

限流上报 timeout 最多 1s,否则影响 ratelimit master 统计。
修复链路追踪缺少对端命名空间 ID 的问题。

1.46.9.1-SpringCloud2021-RELEASE(2024-12-11)

Bug 修复

修复调用旧版本 SDK(注册元数据无 Tag 和 Meta)时的空指针异常。

1.46.9-SpringCloud2021-RELEASE(2024-08-30)

Bug 修复

升级 Spring Framework 到 5.3.39;jose4j 升级到 0.9.4;排除无用的 reactor-netty-http-brave 依赖。
修复 Micrometer 的内存泄露问题。
修复了添加 @EnableCaching 注解时,与 TSF Feign 容错不兼容的问题。
修复配置了泳道规则时,服务无法启动的问题。
修复了路由规则命中但无实例匹配,但依然能转发到后端服务的问题。
修复无服务路由规则时,就近路由失效的问题。

1.46.8-SpringCloud2021-RELEASE(2024-07-29)

新特性

支持 Spring Cloud 服务预热。

优化

注册中心参数支持从命令行参数获取。
连接注册异常后,避免一直请求。

Bug 修复

修复 Feign url 时提示的空指针异常。
更新依赖版本 Spring Framework 5.3.34,Netty 4.1.108,classgraph 4.8.112,Tomcat 9.0.90,bcpkix-jdk18on 1.78.1。

1.46.7-SpringCloud2021-RELEASE(2024-05-09)

新特性

支持优先级路由。
支持主动探测。

优化

Dubbo: 适配开源负载均衡策略及容错策略。

Bug 修复

修复 Spring Cloud Gateway 获取上下文空指针的问题。

1.40.6.1-SpringCloud2021-RELEASE(2024-05-07)

Bug 修复

修复 Spring Cloud Gateway 部分场景(例如OAuth)获取上下文空指针的问题。
修复 Spring Cloud Gateway 开源模式无法跨命名空间访问服务。
修复 Spring Cloud Gateway 无法转发到以 / 结尾的 API。
更新依赖版本 Spring Boot 2.7.18, Jackson 2.15.3, Tomcat 9.0.88, Logback 1.2.13。

1.40.6-SpringCloud2021-RELEASE(2024-03-27)

新特性

scg 网关支持流量改写插件(需控制台支持)。

Bug 修复

修复 OAuth 插件获取 HTTP 头部的大小写判断问题。
修复 Spring Cloud Gateway 实例级熔断不生效的问题。
修复精度丢失导致异常限流的问题。
修复 tsf swagger 和 Spring Boot 2.7 actuator 的空指针兼容问题。
修复 path 参数经过网关后,空格变成+。
升级 Spring Boot 到 2.7.17。

1.40.5.1-SpringCloud2021-RELEASE(2025-06-11)

Bug 修复

修复网关无法访问短路径 API 的问题。


1.40.5-SpringCloud2021-RELEASE(2023-10-08)

新特性

支持调整 Consul HTTP 连接数。

Bug 修复

修复 dubbo2 router 存在 invokers 为空导致数组越界问题。
修复 Spring Cloud Gateway 配置 SSL 时异常的转发逻辑。

1.40.4-SpringCloud2021-RELEASE(2023-06-27)

优化

dependencyManagement 中将 femas-adaptor-tsf-apache-dubbo3 的依赖分为 femas-adaptor-tsf-apache-dubbo3.0 和 femas-adaptor-tsf-apache-dubbo3.1。

Bug 修复

升级 Spring Boot 到 2.7.12,升级 Guava 到 32.0.1-jre。

1.40.2-SpringCloud2021-RELEASE(2023-05-06)

优化

支持补齐 1.40.x 之前的版本支持的能力。
支持通过配置 -Dspring.cloud.consul.enabled=false 关闭连接 consul,适配单元测试场景时的启动。
支持 Nacos 多注册。

Bug 修复

升级 Spring Boot 到 2.7.11,升级 snakeyaml 到 2.0,Netty 升级到 4.1.91,HttpClient 升级到 4.5.14。
修复重复判断,导致限流不准的问题。

1.40.0-SpringCloud2021-RELEASE(2023-01-06)

新特性

支持 TSF 网关使用 kona fiber 协程来提升性能。
支持同时使用 TSF 网关和开源原生网关的能力。支持自定义网关路由策略、支持 WebSocket 以及支持跨域等原生网关能力。
支持 OAuth 插件使用第三方鉴权地址为微服务 API 的能力。
支持开源原生网关使用 TSF 服务治理的能力。
支持服务监听触发回调。
支持查看下发配置。
支持使用 OpenTelemetry Agent 来使用 TSF 监控调用链的能力。

优化

补齐 1.40.x 之前的版本支持的能力。
在限流时把限流 ID 设置到调用链。
熔断,限流事件支持多服务名适配。
优化 Swagger 上报的依赖 Springfox 兼容适配 Spring Cloud TSF 2021。

Bug 修复

修复非单元化场景下,网关监控信息异常的问题。