3.10.3（2024-03-06）

新增

• RPC 支持暴露 Prometheus 監控指標。

• RPC 優化了 Mesh 場景下的使用，添加 Rest 協議支持。

• 注冊中心支持訂閱線程池的相關配置。

更新

• 依賴的 SOFABoot 開源版本從 3.19.1 升級至 3.21.0，版本說明請參見 發布說明。

• 依賴的 Spring Boot 版本從 2.7.15 升級至 2.7.18，版本說明請參見 發布說明。

• 升級以下依賴：

  • registry-client-enterprise-all 5.6.0 升級至 5.6.1。

  • sofa-rpc-enterprise-all 5.9.3 升級至 5.9.4。

  • sofa-rpc-all 5.8.4 升級至 5.11.1。

  • antcloud-antvip-client 1.2.0 升級至 1.2.1。

  • antcloud-antvip-common 1.2.0 升級至 1.2.1。

  • org.apache.dubbo 2.7.18 升級至 2.7.23。

3.10.2（2023-10-27）

更新

更新以下依賴包：

兼容性說明

• SOFABoot 3.10.X 版本基礎依賴框架 Spring Boot 版本升級至 2.7.X 系列。Spring Boot 2.7.x 版本的功能與變更說明，請參見 SpringBoot 2.7.15 及 Spring Boot 2.7 Release Notes。

• 隨著 Spring Boot 升級，Spring Cloud 依賴也需要相應升級至兼容版本 2021.0.x，詳情請參見 Spring Cloud reference。

• 自 SOFABoot 3.10.2 版本開始，Spring Boot 的版本控制采用 import 的方式引入。因此，在不升級 SOFABoot 的情況下，您也可以切換 Spring Boot 的版本，但僅支持切換 2.7.x 系列，建議版本不低于 2.7.15。修改方式，請參見 如何手動升級 SOFABoot 管理的第三方 JAR。

3.6.6（2023-09-19）

新增

RPC 支持配置反序列化類的黑名單，格式為字符串，以英文逗號（,）或英文分號（;）分割多個類名。配置方式如下：

在啟動參數中增加如下參數：

 -Drpc_serialize_blacklist_override=com.test.class,com.test.clazz

修復

• 修復服務訂閱時，首個訂閱服務概率性地出現控制臺 IP 顯示錯誤的問題。

• 修復 RPC 安全漏洞。

• 修復短暫無可用 DRMData 服務時，drm-client 連接無法恢復的問題。

更新

更新以下依賴：

• registry-client-all 5.3.1.cloud.20230227 升級至 5.3.1.cloud.20230509。

• sofa-rpc-enterprise-all 5.8.15 升級至 5.8.16。

• drm-client 3.9.3.4 升級至 3.9.3.5。

3.6.5（2023-04-19）

新增

• SOFARPC 兼容支持 Dubbo 2.6.X 以及 2.7.X 版本，默認升級至 2.7.18 版本。

• 批處理客戶端支持連接服務端指定端口，通過 batch.server.port 進行自定義端口配置。例如 batch.server.port=9001。

• 更新 SOFARPC 的灰度標簽 Key 為SOFA_GREY_LANE：

  • 如果配置了SOFA_GREY_LANE或SOFA_GROUP_NAME環境變量，則路由到灰度分組。

  • 如果配置了SOFA_GROUP_DEFAULT環境變量，則路由到默認分組。

  • 如果都沒配置，則路由到任意后端。

修復

• 修復 ACVIP 客戶端連接舊版本服務端（0.21.0 以下版本，不包含 0.21.0）時，長輪詢失效問題。

  該兼容性問題自 3.4.11 版本出現。

• 修復 ACVIP Client 日志根路徑錯誤問題。

  logback 和 log4j2 優先采用sofa.logging.path來獲取根路徑配置；如果為空，則使用logging.path作為默認路徑。log4j 已經停止維護不建議使用。

更新

更新以下依賴：

• rpc 5.9.1 升級至 5.9.2。

• commons-io 2.2 升級至 2.11.0。

• commons-codec 1.4 升級至 1.5。

• antvip 1.1.4 升級至 1.2.0。

• gson 2.8.7 升級至 2.8.9。

3.6.4（2022-09-06）

新增

修復

更新

更新以下依賴：

3.6.3（2022-09-05）

新增

-Dcom.alipay.sofa.rpc.compatible.rms3124=true

修復

更新

兼容性提示

3.4.20（2024-07-08）

修復

修復應用啟動時，DRM 心跳線程與部分 DRM 資源首次拉取出現概率性沖突導致的 DRM 配置了值，但客戶端提示拉取不到的問題。

3.4.19（2023-12-13）

新增

• RPC 在 Mesh 場景下支持 REST 協議。

• Mesh 場景下，自動關閉 RPC 框架中的服務治理功能。

• 注冊中心客戶端支持在配置文件中進行相關屬性配置。

更新

更新以下依賴包：

• sofa-rpc-enterprise-all 5.8.15 升級至 5.8.16。

• registry-client-enterprise-all 5.6.0 升級至 5.6.1。

3.4.18（2023-09-19）

新增

RPC 支持配置反序列化類的黑名單，格式為字符串，以英文逗號（,）或英文分號（;）分割多個類名。配置方式如下：

在啟動參數中增加如下參數：

 -Drpc_serialize_blacklist_override=com.test.class,com.test.clazz

修復

• 修復服務訂閱時，首個訂閱服務概率性地出現控制臺 IP 顯示錯誤的問題。

• 修復 RPC 安全漏洞。

• 修復短暫無可用 DRMData 服務時，drm-client 連接無法恢復的問題。

更新

更新以下依賴：

• registry-client-all 5.3.1.cloud.20230227 升級至 5.3.1.cloud.20230509。

• sofa-rpc-enterprise-all 5.8.15 升級至 5.8.16。

• drm-client 3.9.3.4 升級至 3.9.3.5。

3.4.17（2023-05-30）

新增

• RPC 支持 Mesh 場景下的 LDC 路由。

• 注冊中心支持數據壓縮能力。

更新

更新以下依賴：

• sofa-rpc-enterprise-all 5.8.14 升級至 5.8.15。

• registry-client-all 5.3.1.cloud.20210713 升級至 5.3.1.cloud.20230227。

3.4.16（2023-03-07）

新增

• SOFARPC 兼容支持 Dubbo 2.6.X 以及 2.7.X 版本，默認升級至 2.7.18 版本。

• 批處理客戶端支持連接服務端指定端口，通過 batch.server.port 進行自定義端口配置。例如 batch.server.port=9001。

修復

• 修復 ACVIP Client 日志根路徑錯誤問題。

  logback 和 log4j2 優先采用 sofa.logging.path 來獲取根路徑配置；如果為空，則使用 logging.path 作為默認路徑。log4j 已經停止維護不建議使用。

• 修復 ACVIP 客戶端連接舊版本服務端（0.21.0 以下版本，不包含 0.21.0）時，長輪詢失效問題。

  該兼容性問題自 3.4.11 版本出現。

更新

更新以下依賴：

• gson 2.8.6 升級至 2.8.9。

• antvip 1.1.4 升級至 1.2.0。

• rpc 5.8.13 升級至 5.8.14。

• commons-codec 1.4 升級至 1.15。

• commons-io 2.2 升級至 2.11.0。

3.4.15（2022-07-25）

修復

修復 SOFARPC 熔斷配置與實際熔斷誤差問題。例如配置熔斷請求數為 1，RT為 1ms。當第一個請求超過 1ms 時，第二個請求不會發生熔斷，第三個請求會發生熔斷。新版本修復了該問題，在如上場景中，第二個請求會正常熔斷。

3.4.14（2022-06-30）

新增

Tomcat 支持禁用不安全的 HTTP 請求：新增配置參數 com.alipay.sofa.security.tomcat.method.disabled，默認取值為 false，對 HTTP 的方法不做任何限制。當該配置為 true時，Tomcat 禁用除 GET、POST 以外的其他 HTTP 請求。

修復

修復 tracerlog 日志目錄不能通過 logging.path進行指定的缺陷，該缺陷自 3.4.11 版本出現。

更新

更新以下依賴：

• fastjson 1.2.78 升級至 1.2.83_noneautotype。

• jackson 2.11.2 升級至 2.13.2.1。

• logback 1.2.3 升級至 1.2.8。

• dubbo 2.6.7 升級至 2.6.12。

• tomcat 9.0.31 升級至 9.0.43。

• com.antcloud.antvip:antcloud-antvip-common 1.1.0 升級至 1.1.4。

• com.antcloud.antvip:antcloud-antvip-client 1.1.0 升級至 1.1.4。

3.4.13（2022-06-20）

新增

• SOFARPC 添加了面向混合云場景的路由支持，使用此功能需開啟混合云路由開關：

  • 單元化場景：如果無法獲得目前單元的可用服務地址，則通過網關進行路由轉發（需預先部署跨單元互通的網關）。

  • 非單元化場景：在提供者和消費者均配置了位置信息的情況下，將優先按照 zone > datacenter >region 的順序進行路由尋址。

• triple 協議支持使用 gateway 注冊中心。

修復

修復了服務路由規則的權重配置邊界值（0 或空值）會發生異常的缺陷。

更新

更新依賴：sofa-rpc-enterprise-all 5.8.9 升級至 5.8.12。

3.4.12（2022-03-28）

更新

更新以下依賴：

• com.alipay.sofa:antschedulerclient-core 1.3.4 升級至 1.7.0。

• com.alipay.sofa:antschedulerclient-acvip 1.3.4 升級至 1.7.0。

3.4.11（2021-12-21）

新增

• 增加 DRM、ACVIP、Registry 同機房調用收斂。

• 增加 log4j-core 漏洞修復版本。

• run.mode字段允許配置數字。

修復

• 修復了集群任務多層拆分，每層只返回一個分片導致重復執行問題。

• 修復了 SOFATracer datasource 自動配置開關失效問題。

更新

更新以下依賴：

• sofaboot-dependencies 3.4.5 升級至 3.4.7。

• sofatracer-all 3.1.1 升級至 3.1.2。

• zoneclient-core 1.1.1 升級至 1.2.1.antcloud。

• drm.version 3.9.3.3 升級至 3.9.3.4。

• acvip.version 1.0.7 升級至 1.1.0。

• registry.version 5.1.1 升級至 5.5.1.RELEASE。

• ant.scheduler.version 1.1.6 升級至 1.3.4。

• 新增 registry-client-all : 5.3.1.cloud.20210713 依賴。

• metrics.client.version 2.0.2 升級至 2.0.3。

• fastjson 1.2.69 升級至 1.2.78。

• hessian 3.3.12 升級至 3.3.13。

• 新增 log4j-core 漏洞修復版本：2.11.2_nonelookup2 依賴

3.4.9（2021-07-29）

修復

RPC 修復消費者的默認超時配置導致服務端超時配置失效的問題。

更新

3.4.8（2021-07-16）

新增

允許清除 HTTP 請求內部 RPC 線程的上下文內容，由環境變量 com.alipay.sofa.rpc.mvcRemoveRpcContext控制。默認為 false（不清除）。

修復

SOFARPC xsd 配置與開源不一致問題。

更新

3.4.7（2021-03-26）

新增

• 新增 sofa.common.toolsJAR 包，版本為 1.3.2。

• drm-client 默認關閉 JMX（Java Management Extensions）。

• drm-client 支持 Spring Cloud，根據 resourceId 獲取整個 Resource。Resource 以 properties 格式返回。

修復

• default.registry參數不可配置問題。

• 3.4.6 版本引入的 ZoneClient 1.1.1 版本的 sofa-middleware-log依賴問題。

• SOFARPC 下 SOFAGateway 建立連接失敗導致連接被打滿問題。

• SOFA 框架 log4j 日志配置不合理問題。

• SOFARPC 對 SOFAREST 服務治理能力不支持問題。

更新

• RPC 商業版升級至 5.8.7；開源版升級至 5.7.7。

• drm-client 升級至 3.9.3.3。

3.4.6（2020-11-15）

修復

• 啟動時 SOFABoot 版本顯示不正確的問題。

• 啟動時找不到日志配置文件的問題。

更新

• 依賴的 SOFABoot 開源版本升級至 3.4.6。

• sofa.hessian.version 更新至 3.3.11。

3.4.5（2020-11-15）

新增

• SOFARPC 故障注入能力。

• SOFARPC 服務路由。

• SOFARPC 服務熔斷。

修復

• 在方法拋異常時，@Tracer方法注解攔截器會重復移除 Trace 上下文這個 Bug。

• 修復安全漏洞。

更新

• 依賴的 SOFABoot 開源版本升級至 3.4.5。

• SOFARPC 版本升級至 5.8.5。

• Guardian 版本升級至 1.4.15。

• jackson.version 升級至 2.11.2。

• sofa.hessian.version 升級至 3.3.10。

• 服務熔斷模型，統一 Mesh 和 RPC 熔斷模型。

• 二方包 com.alipay.zoneclient:zoneclient-core:1.1.0升級至 com.alipay.zoneclient:zoneclient-core:1.1.1，解決了 zoneclient對中樞管控的強依賴，避免公共云跨 VPC 網絡訪問。

3.4.4（2020-08-05）

修復

• 預熱轉發功能未生效的問題。

• 服務鑒權問題。

• AuthFilter 錯誤引用的問題。

更新

• 依賴的 SOFABoot 開源版本升級至 3.4.4。

• SOFA RPC 版本升級至 5.8.3。

3.4.3（2020-07-29）

修復

• Guardian 自動配置時，初始化時機過早問題。

• 框架向 JVM System 設置變量時，沒有 trim 操作所導致的 key 讀取錯誤問題。

• AntScheduler ONEWAY 集群的內存泄露問題。

• AntScheduler 切片（Sharding）時，MD5 一致性檢查失敗的問題。

更新

AntScheduler Client 版本升級至 1.1.6。

3.4.2（2020-06-24）

新增

SOFARPC 應用級服務鑒權，根據 服務級鑒權規則開關狀態，來決定鑒權規則生效的粒度。主要規則如下：

• 開關打開：粗粒度的服務級鑒權規則生效。

• 開關關閉：細粒度的應用級鑒權規則生效。

修復

• 發布時 uniqueName 計算錯誤，導致 unexport 失敗的問題。

• zoneClient 在第一次調用 RPC 時耗時較長的問題。

更新

• 調整 LdcRouteProvider order。

• 依賴的 SOFABoot 開源版本升級至 3.4.1。

3.4.1（2020-06-02）

新增

Bolt 協議對 JSON 序列化接口多參數的支持。

更新

• Fastjson 升級至 1.2.69。

• 依賴的 SOFABoot 開源版本升級至 3.4.1。

• 二方包 com.alibaba:fastjson:1.2.67升級至 com.alibaba:fastjson:1.2.69。

3.3.2（2020-04-15）

新增

• SOFARPC 支持 Swagger 展示接口信息。

• Linke 支持聯調環境。

修復

服務訪問控制的配置失效問題。

更新

• FastJson 版本升級至 1.2.67。

• SOFARest 版本升級至 1.7.2。

• SOFALookout 版本升級至 1.5.7。

• 依賴的 SOFABoot 開源版本升級至 3.3.2。

• 二方包：

  • com.alibaba:fastjson:1.2.66升級至 com.alibaba:fastjson:1.2.67

  • com.alipay.sofa:sofa-rest-runtime-integration:1.6.16升級至 com.alipay.sofa:sofa-rest-runtime-integration:1.7.2

  • com.alipay.sofa:sofa-rest-api:1.6.16升級至 com.alipay.sofa:sofa-rest-api:1.7.2

  • com.alipay.sofa:sofa-rest-log:1.6.16升級至 com.alipay.sofa:sofa-rest-log:1.7.2

  • com.alipay.sofa:sofa-rest-spi:1.6.16升級至 com.alipay.sofa:sofa-rest-spi:1.7.2

  • com.alipay.sofa:sofa-rest-common:1.6.16升級至 com.alipay.sofa:sofa-rest-common:1.7.2

  • com.alipay.sofa:sofa-rest-core:1.6.16升級至 com.alipay.sofa:sofa-rest-core:1.7.2

  • com.alipay.sofa:sofa-rest-spring:1.6.16升級至 com.alipay.sofa:sofa-rest-spring:1.7.2-com.alipay.sofa.lookout:lookout-enterprise-sofa-boot-starter:1.5.4升級至 com.alipay.sofa.lookout:lookout-enterprise-sofa-boot-starter:1.5.7

3.3.1（2020-03-17）

更新

• FastJson 升級至 1.2.66。

• 管控的 DTX Client 升級至 2.1.1。

• 依賴的 SOFABoot 開源版本升級至 3.3.1。

• Spring Boot 版本至 2.1.13.RELEASE，Tomcat AJP 漏洞在 Spring Boot 這個版本中得到修復。

  說明

  SOFABoot 默認沒有使用 Tomcat AJP，因此不受此漏洞影響。此次升級內置的 Tomcat，更能保證安全性。

• 二方包：

  • com.alibaba:fastjson:1.2.62升級至 com.alibaba:fastjson:1.2.66

  • com.alipay.dtx:dtx-sofaboot:2.1.0升級至 com.alipay.dtx:dtx-sofaboot:2.1.1

    說明

    移動開發（mPaaS）對應 starter 最新版本為 2.3.0。LDC 功能默認是開啟的，如果您的應用不支持 LDC 功能，請務必在應用的主 pom.xml 中添加下述依賴：

    <dependency><br/>
         <groupId>com.alipay.sofa</groupId><br/>
         <artifactId>runtime-enterprise-sofa-boot-starter</artifactId><br/>
    </dependency>

3.3.0（2020-02-24）

新增

• 支持 單元化介紹。

  說明

  LDC 功能默認是開啟的，如果您的應用不支持 LDC 功能，請務必在應用的主 pom.xml 中添加下述依賴：

  <dependency>
       <groupId>com.alipay.sofa</groupId>
       <artifactId>runtime-enterprise-sofa-boot-starter</artifactId>
  </dependency>

• RPC Reference 超時配置支持 EL 表達式。

• SOFAMQ starter。

更新

• 依賴的 SOFABoot 開源版本升級至 3.3.0。

• Spring Boot 版本升級至 2.1.11.RELEASE。

• 二方包：

  • com.alipay.sofa:sofa-rpc-enterprise-all:5.6.2升級至 com.alipay.sofa:sofa-rpc-enterprise-all:5.7.0

  • com.alibaba:fastjson:1.2.60升級至 com.alibaba:fastjson:1.2.62

3.2.2（2020-02-14）

新增

• 默認依賴健康檢查的 Starter。

• 二方包：

  • com.alipay.sofa:sofa-tracer-datasource-plugin:3.0.10

  • com.alipay.sofa:sofa-tracer-flexible-plugin:3.0.10

  • com.alipay.sofa:sofa-tracer-resttmplate-plugin:3.0.10

  • com.alipay.sofa:sofa-tracer-springmvc-plugin:3.0.10

  • com.alipay.sofa:sofa-tracer-spring-cloud-plugin:3.0.10

  • com.alipay.sofa:sofa-tracer-zipkin-plugin:3.0.10

修復

健康檢查失敗問題。

更新

• 依賴的 SOFABoot 開源版本升級至 3.2.2。

• 二方包：

  • com.alipay.sofa:antschedulerclient-core:1.0.7升級至 com.alipay.sofa:antschedulerclient-core:1.0.8

  • com.alipay.sofa:antschedulerclient-antvip:1.0.7升級至 com.alipay.sofa:antschedulerclient-antvip:1.0.8

  • com.alipay.sofa:tracer-core:3.0.8升級至 com.alipay.sofa:tracer-core:3.0.10

  • com.alipay.sofa:tracer-extensions:3.0.8升級至 com.alipay.sofa:tracer-extensions:3.0.10

  • com.alipay.sofa:sofa-tracer-httpclient-plugin:3.0.8升級至 com.alipay.sofa:sofa-tracer-httpclient-plugin:3.0.10

  • com.alipay.common:tracer:3.0.5升級至 com.alipay.common:tracer:3.0.7

  • com.alipay.sofa:tracer-enterprise-httpclient-plugin:3.0.5升級至 com.alipay.sofa:tracer-enterprise-httpclient-plugin:3.0.7

  • com.alipay.sofa:tracer-enterprise-dst-plugin:3.0.5升級至 com.alipay.sofa:tracer-enterprise-dst-plugin:3.0.7

    說明

    移動開發（mPaaS）對應 starter 最新版本為 2.3.0。

3.2.1（2019-12-17）

新增

• 配置文件支持以 yml 結尾。

• 支持 Bolt 動態 API。

• RPC 支持用戶使用 Zookeeper 作為注冊中心。

• RPC 支持注解發布和引用服務。

• RPC 支持優雅關閉。

修復

健康檢查失敗問題。

更新

• 依賴的 SOFABoot 開源版本至 3.2.1。

  說明

  使用了任務調度的應用請勿升級為 sofaboot 3.2.1 版本。

• 二方包：

  • com.alipay.sofa:tracer-core:3.0.7升級至 com.alipay.sofa:tracer-core:3.0.8

  • com.alipay.sofa:tracer-extensions:3.0.7升級至 com.alipay.sofa:tracer-extensions:3.0.8

  • com.alipay.sofa:tracer-enterprise-httpclient-plugin:3.0.4升級至 com.alipay.sofa:tracer-enterprise-httpclient-plugin:3.0.5

  • com.alipay.sofa:tracer-enterprise-sofa-boot-starter:3.0.4升級至 com.alipay.sofa:tracer-enterprise-sofa-boot-starter:3.0.5

  • com.alipay.common:tracer:3.0.4升級至 com.alipay.common:tracer:3.2.1

  • com.antcloud.antvip:antcloud-antvip-client:1.0.6升級至 com.antcloud.antvip:antcloud-antvip-client:1.0.7

  • com.antcloud.antvip:antcloud-antvip-common:1.0.6升級至 com.antcloud.antvip:antcloud-antvip-common:1.0.7

  • com.alipay.sofa:bolt:1.4.6升級至 com.alipay.sofa:bolt:1.5.6

    說明

    移動開發（mPaaS）對應 starter 最新版本為 2.3.0。

3.1.0（2019-09-02）

新增

• 擴展點能力，詳情請參見 SOFABoot 拓展點。

• 模塊化能力，詳情請參見 模塊化開發。

• bean 異步初始化能力，詳情請參見 Spring Bean 異步初始化。

修復

RPC 在網絡波動情況下可能存在的循環斷連重連問題。

更新

• SOFARPC、MQ、Tracer 及 Guardian 托管中間件版本：參見本文檔所發布的最新版本中更新的 starter 信息匯總表。

• 增強使用注解發布引用服務能力，詳情請參見 JVM 服務發布與引用。

• 依賴的 SOFABoot 開源版本至 3.1.0。

  • 基礎依賴框架 Spring Boot 2.0.3.RELEASE 版本升級至 2.1.0.RELEASE版本。

    Spring Boot 2.1.0.RELEASE 版本的功能與變更說明，參見 SpringBoot 2.1.0.RELEASE及 Spring Boot 2.1 Release Notes。

  • Spring Boot 升級，Spring Cloud 依賴也需要相應升級至兼容版本 Greenwich 系列。

• 二方包：

  • com.alipay.sofa:tracer-core:3.0.1升級至 com.alipay.sofa:tracer-core:3.0.3

  • com.alipay.sofa:tracer-extensions:3.0.1升級至 com.alipay.sofa:tracer-extensions:3.0.3

  • com.alipay.sofa:tracer-enterprise-httpclient-plugin:3.0.0升級至 com.alipay.sofa:tracer-enterprise-httpclient-plugin:3.0.1

  • com.alipay.sofa:tracer-enterprise-sofa-boot-starter:3.0.0升級至 com.alipay.sofa:tracer-enterprise-sofa-boot-starter:3.0.1

  • com.alipay.common:tracer:3.0.0升級至 com.alipay.common:tracer:3.0.1

  • com.alipay.sofa.lookout:lookout-enterprise-sofa-boot-starter:1.5.1升級至 com.alipay.sofa.lookout:lookout-enterprise-sofa-boot-starter:1.5.4

  • com.alipay.sofa.lookout:lookout-api:1.5.0升級至 com.alipay.sofa.lookout:lookout-api:1.5.4

    說明

    移動開發（mPaaS）對應 starter 最新版本為 2.3.0。