Release Notes on Apache Dubbo

Dubbo Java 3.1.4 正式发布

Thu, 01 Dec 2022 00:00:00 +0000

Dubbo 3.1.4 版本是目前 Dubbo 3 的最新稳定版本，我们建议所有的用户都升级到最新的稳定版本。

Dubbo 3.1.4

新特性

Dubbo QoS 支持指定白名单 IP 列表访问所有命令

Bugfix

修复在泛化调用时 Dubbo Metrics 采集方法名错误
修复使用 Zookeeper 作为元数据中心时，上报接口映射可能存在相互覆盖的问题
修复 timeout countdown 在 Triple 协议的支持
修复 timeout countdown 存在透传的问题
修复多注册中心请求时，由于没有可用的地址导致的 NPE 问题
修复 Mesh 模式下 Triple 获取 remoteApplicationName 为空的问题
修复 GraalVM Native Image 的支持
修复端口复用时无 SSL 连接导致的 NPE 异常
完善 JDK 编译器报错日志的输出格式
修复 MetadataReportConfig 部分配置时应用无法启动的问题
修复 dubbo.reference 作为默认参数在 3.x 版本中不生效的问题
完善 Zookeeper 连接失败的日志
修复 ReferenceConfig 中配置的 ClassLoader 可能被覆盖的问题
修复部分属性在应用级服务发现时被缓存在实例级的地址中导致方法级配置失效的问题
修复 Triple 协议 onError 异常的问题

FAQ

本次发布中有 3 个提交涉及异常日志 FAQ 的完善。关于错误码机制请参考官网错误码机制介绍一文。（https://cn.dubbo.apache.org/zh-cn/overview/java-sdk/reference-manual/faq/intro/）

Dubbo Java 3.0.2 发版公告

Sun, 18 Jul 2021 00:00:00 +0000

新特性

支持通过 @DubboService 注解暴露泛化服务
元数据中心xml格式的配置支持 protocol 和 port 属性
兼容 curator5 以上的版本
点对点调用支持*通配符进行匹配, 一个提供者地址可对应多个接口
为应用级别的服务发现增加动态配置去进行规则覆盖
对提供者测的动态配置覆盖规则提供开关，可以使提供者无视动态配置，不重新暴露
支持 native image
提供取消执行 shutdown hook 的开关
支持 Kubernetes Mesh 的服务治理规则
Netty 连接支持 SSL 配置

Bug 修复

DubboBootStrap start 重复调用后，动态配置被覆盖
动态配置规则被删除后，依然生效
triple 协议在暴露时会抛出空指针异常
ConfigCenterConfig.setAddress 方法会覆盖掉 username 属性
DefaultFuture.closeChannel 会销毁掉消费端测的线程池
TripleClientHandler.writeRequest 抛出空指针异常
解析3.0迁移规则异常时会抛出空指针异常
Activated Extensions 的顺序性问题
URLAddress.parse 方法在解析 ipv6 地址时存在问题
用户自定义的参数在 properties 配置中不生效
同时使用 API 模式和 Spring 模式配置时属性，Config Id 存在覆盖问题
应用级别服务发现在启动时不生效
Nacos 注册中心无法动态感知提供者的数量变化
${dubbo.application} 在 xml 文件中无法被 spring 的 placeholder 规则给解析替换
获取实例参数的顺序问题，先去获取了实例级别参数，再去获取接口级别参数
当 DubboConfigBeanInitializer 不存在时，注册应用启动监听器会抛出异常
Mock 时参数中包含 ‘:’ 或者 ‘=’ 字符时，不生效
删除 Mesh 规则时空指针异常

优化

抓住 RemovalTask 的异常，保证信号量能够释放
通过唯一 service name 检查 ReferenceConfig/ServiceConfig 是否重复
优化生成随机数的性能
如果用户使用接口级别去做服务发现，不发布应用与接口的映射数据到元数据中心
使用 StringBuilder#append(Char) 提升性能
保证 GRPC 编译的类文件中接口的顺序
优化 reference bean 的占位符解析
MergeableClusterInvoker 中使用 CompletableFuture#get(long, TimeUnit) 去提升性能
内置服务 MetadataService 不延迟暴露
优化 ConfigBean 和 Bootstrap 的启动逻辑
优化 Config 检查是否重复的逻辑
使用 Ring 数据结构去进行注册通知
优化动态配置的初始化逻辑
ConfigManager 使用 ConcurrentHashMap 去移除锁逻辑，提升 equals 和 toString 性能
优化 MetadataInfo equals 方法以及 Instance Listener
优化异步 export/refer 逻辑
使用 TreeSet 数据结构保证应用级别服务发现时应用名称的顺序一致
RegistryNotifier 的第一个十次通知不延迟
dubbo-compile 编译使用新的格式生成 stub
Mesh 服务治理规则在动态配置中心的分组和其他规则分组统一，由 DEFAULT_GROUP 改成 dubbo
使用 nacos 用作注册中心时，可以在注册中心地址中使用参数来改变在 nacos 中的分组
计算 ServiceInfo 的 reversion 时，移除运行时参数，避免生成多个 reversion
Nacos 注册中心抛出异常时，将异常封装称 RpcException 抛出
禁止动态配置中心对一些权限参数进行动态修改
优化 Config Bean 的初始化流程，并兼容 spring 3.x/4.1.x
Bootstrap.start 方法可重入，暴露或引用新的服务
将 org.apache.dubbo 包中的类默认添加到白名单中
保证生成的 Config 的 Id 唯一，并检查 Config 是否之前存在
Javaassist 兼容改变 override 声明字段
重构解码时的检查逻辑，当找不到 path, version 对应的提供者是，抛出异常
当 ApplicationModel 为 null 时，兼容 adaptive extensions

代码质量提升

感谢以下提高 Apache Dubbo 的稳定性的贡献。

Dubbo Java 3.1.3 正式发布

Mon, 18 Jul 2022 00:00:00 +0000

Dubbo 3.1.3

修改内容

修复本地调用的过程中 Filter 顺序异常的问题
支持导入协议配置项到 MetadataService
支持在发布 MetadataService 时自动选择可用端口
完善错误码内容
泛化调用下支持一致性哈希负载均衡
修复泛化调用时反序列化异常的问题
修复由于 JVM Methods 顺序不一致导致的应用级元数据无法复用的问题
默认关闭端口复用能力，修复 remoting 组建找不到 SPI 的问题
修复由于引用计数异常导致的 safe gard 问题
删除 Nacos 注册中心组建中使用的 guava 依赖
修复接口级使用 Nacos 注册中心时由于地址聚合导致的无法下线的问题
多个代码质量优化提交

新贡献者

@zhangzq7 在 #10847 中提交了第一个贡献
@akaakking 在 #10799 中提交了第一个贡献
@wxbty 在 #10921 中提交了第一个贡献
@haoxz11 在 #10937 中提交了第一个贡献

新贡献者

@weixsun 在 #10941 中提交了第一个贡献

未来的版本规划

3.0、3.1、3.2 有什么区别？未来会怎么发展？发版周期是怎么样的？更多的版本迭代规划也将在近期推出，欢迎关注 Apache Dubbo 官方公众号获取最新的信息。

Dubbo Java 3.2.0-beta.3 正式发布

Sun, 18 Dec 2022 00:00:00 +0000

Dubbo 3.2.0-beta.3 版本是目前 Dubbo 3 的最新特性版本，包括了如 Spring Boot 3、JDK 17、服务粒度的线程池隔离等新特性的支持，欢迎大家尝鲜使用。

Dubbo 3.2.0-beta.3

注：Dubbo 3.2.0-beta.3 的代码基础和 Dubbo 3.1.4 完全一致，因此在 Dubbo 3.1.4 中包括的所有修改内容，在 Dubbo 3.2.0-beta.3 中也同样存在，后续说明中对于重复的内容讲不再赘述。

新特性

支持使用 jackson 作为Dubbo 内部的 JSON 序列化方式
优化 Dubbo Logger 的选择逻辑，在存在多种日志框架的情况下会尝试读取其配置，选择一个有效的日志框架，解决在 SpringBoot 等场景下 Dubbo 日志不输出的问题。
Triple 协议支持客户端流控
支持发布 Dubbo Metrics 数据到 Spring Boot 的 Endpoints 上
支持可选关闭线程池满时的线程 Dump 以及支持配置 Dump 的结果输出路径
xDS 实现支持路由规则的解析
支持 Dubbo QoS 命令安全性分级，默认对外暴露存活检测的端口，支持 Kubernetes 的原生接入
支持基于 P2C 的自适应负载均衡

Bugfix

修复默认 Metadata 缓存未开启的问题
修复 Metrics 指标资源路径错误的问题
完善线程池隔离的配置，默认采用共享线程池，避免创建过多的线程
完善 prefer-serialization 的选择逻辑，提供向前兼容的能力
修复 Triple 协议传输时未携带版本号导致版本调用错误的问题
完善 GraalVM Native Image 的支持

性能优化

优化在连接数高时由于获取 channels 数量导致的资源占用问题

代码优化

本次发布中有 5 个提交涉及代码质量的优化。

Dubbo 3.2.0-beta.2 正式发布

Fri, 18 Nov 2022 00:00:00 +0000

Dubbo 3.2.0-beta.2

修改内容

切换到在用户线程序列化，提升协议性能
支持 Netty3 的端口复用
修复存在多个用户配置的 providedBy 时不生效的问题
支持 istio 的 first-party-jwt 能力
删除 fastjson 和 gson 的传递依赖
支持可选 appResponse 不透传的能力
切换到 Fastjson2 为默认序列化依赖
完善注册中心推送的日志
修复路由刷新时机早于服务目录刷新时机的问题
关闭地址推空保护
更新支持 GraalVM Native 的 SPI 生成代码
支持使用 plain text 模式传输 xds 通道
支持 Nacos 批量注册，修复多注册覆盖的问题
支持 Spring Framework 6 and Spring Boot 3
多个代码质量优化提交
前述 Dubbo 3.1.3 的所有修改内容

新贡献者

@weixsun 在 #10941 中提交了第一个贡献

未来的版本规划

Dubbo Java 2.7.14 发版公告

Mon, 18 May 2020 00:00:00 +0000

变动项

为 ServiceDiscovery 增加动态配置中心的覆盖规则。（#8389）
修复当 mock 参数中包含 ‘:’ 或者 ‘=’ 符号时无法正常使用的问题。（#8379）
修复 zone 参数对 ZoneAwareClusterInvoker 配置无法生效的问题。（#8521）
为序列化白名单检查增加开关，默认为 true。（#8537）
修复当请求超时时序列化检查的空指针异常。（#8587）
修复 NetUtils.ignoreNetworkInterface 无法处理网卡中包含 ‘(’ 符号的问题。（#8629）
统一获取本地地址的方式。（#8679）
修复当重试参数为0，依旧会重试1次的问题。（#8743）
当清除未使用的 invoker 时，立即关闭客户端。（#8756）
修复 destroy 方法以及 doOverrideIfNecessary 中的异常。（#8683）
DefaultFuture.closeChannel 根据日志级别选择是否打印请求的详细数据。（#8778）
使用 MapUtils 替换 AttachmentsAdapter（#8772）

Maven依赖变化

netty4: 4.1.51.Final -> 4.1.66.Final
netty4_ssl: 2.0.39.Final -> 2.0.40.Final
http_client: 4.5.3 -> 4.5.13
jetty: 9.4.11.v20180605 -> 9.4.43.v20210629
apollo_client: 1.1.1 -> 1.8.0
tomcat_embed: 8.5.31-> 9.0.48
commons_io: 2.6 -> 2.7
curator: 5.0.0 -> 5.1.0
hessian_lite: 3.2.8 -> 3.2.11

Apache Dubbo 多语言体系再添新员：首个 Rust 语言版本正式发布

Sun, 23 Oct 2022 00:00:00 +0000

Dubbo Rust 定位为 Dubbo 多语言体系的重要实现，提供高性能、易用、可扩展的 RPC 框架，同时通过接入 Dubbo Mesh 体系提供丰富的服务治理能力。本文主要为大家介绍 Dubbo Rust 项目基本情况，通过一个示例快速体验 Rust 首个正式版本特性，并给出了 Dubbo Rust 社区的近期规划，适合于关注或正在采用 Rust 语言的开发者与企业用户阅读。

1 Dubbo Rust 简介

Dubbo 作为 Apache 基金会最活跃的明星项目之一，同时也是国内最受欢迎的开源微服务框架，在易用性、高性能通信、服务治理等方面有着非常大的优势，通过 Dubbo3、Dubbo Mesh 等提供了云原生友好的开发与部署模式。与此同时，Dubbo 的多语言体系也得到了快速发展，长期以来提供的有 Java、Golang 两种语言实现，Rust、Node、Python、C++ 等语言实现的支持也已在社区正式启动。

Dubbo 官网 https://dubbo.apache.org/
Dubbo Java https://github.com/apache/dubbo/
Dubbo Golang https://github.com/apache/dubbo-go/
Dubbo Rust https://github.com/apache/dubbo-rust/

Dubbo Rust 目标是对齐 Dubbo3 的所有核心功能设计，包括基于 HTTP/2 的高性能通信、用户友好的微服务开发编程模式、通过接入DubboMesh提供丰富的服务治理能力等，相比于其他语言实现，Dubbo Rust 将很好的利用 Rust 语言极致性能、安全和指令级掌控能力的特点。对于微服务框架，主流的编程语言都有对应的实现，而 Dubbo Rust 将很好的填补 Rust 领域的空白：

Golang：在微服务框架领域已经占据着很重要的地位；开源社区出现了dubbo-go、gRPC、go-micro、go-zero等多个微服务框架
Java：国内用户量最大的编程语言，Spring Cloud、Dubbo等优秀的微服务框架已经非常流行
C/C++：brpc、grpc 等微服务框架
Rust：目前没有很完善的微服务框架

依托 Dubbo 庞大的用户群，以及 Dubbo 体系下的 Mesh 服务治理整体方案规划。Dubbo Rust 可以轻松地融入到现有的云原生研发体系中，不会增加使用者的研发负担。下图是社区推出的 Dubbo Mesh 架构设计。

Dubbo Java 3.0.2.1 发版公告

Mon, 23 Aug 2021 00:00:00 +0000

这是 3.0.2 的错误修正版本。除了以下更改外，与版本 3.0.2 完全相同。

Bug 修复

修复 nacos group 在消费者端不生效的问题 (#8533)
修复请求超时时序列化检查的 NPE (#8547)
兼容使用 dubbo-all 时未导入 farbic-io 包的问题 (#8546)

Dubbo Java 3.0.1 发版公告

Fri, 02 Jul 2021 00:00:00 +0000

优化

重构服务自省映射关系，支持地址迁移时直接配置上游应用名
为 Spring 扫描添加缓存
优化配置覆盖逻辑
支持 Servlet 环境下控制 Dubbo 生命周期
添加 ServiceListener 用于监听 ServiceConfig
优化方法回调参数设置

Bug 修复

启用强制校验
更正多注册中心情况下，一个注册中心启动时无地址就销毁的逻辑
移除冗余的日志输出
忽略无效的 MetadataReportConfig
修复消费端启动时 NPE 的情况
修复若干和低版本兼容问题
修复若干应用级服务发现逻辑存在的问题
优化地址迁移规则，支持应用级地址重订阅
修复 MetadataInfo 存在 NPE 的情况
修复应用级注册到注册中心的实例信息被错误覆盖的问题

代码质量提升

感谢以下提高 Apache Dubbo 的稳定性的贡献。

#8043, #8044, #8048, #8071, #8119, #8132

Dubbo Go 1.4.0

Tue, 12 Jan 2021 00:00:00 +0000

得益于社区活跃的支持，2020 年 3 月 25 日我们发布了一个让人兴奋的版本——dubbo-go v1.4.0。除了继续支持已有的 Dubbo 的一些特性外， dubbo-go 开始了一些自己的创新尝试。

这个版本，最大的意义在于，做了一些支持云原生的准备工作。比如说，社区在探讨了很久的 k8s 落地之后，终于拿出来了使用 k8s 作为注册中心的解决方案。

其次一个比较大的改进是–我们在可观测性上也迈出了重要的一步。在这之前，dubbo-go只提供了日志这么一个单一手段，内部的信息比较不透明，这个版本将有很大的改善。

最后一个令人心动的改进是，我们支持了 REST 协议。

1. K8s 注册中心

dubbo-go 注册中心的本质为K/V型的数据存储。当前版本实现了以 Endpoint 为维度在 k8s API Server 进行服务注册和发现的方案【下文简称 Endpoint 方案】，架构图如下。

Endpoint 方案，首先将每个 dubbo-go 进程自身服务信息序列化后，通过 Kubernetes 提供的 Patch 的接口写入在自身 Pod 对象的 Annotation 中。其次，通过 Kubernetes 的 Watch 接口观察集群中本 Namespace 内带有某些固定lable [见上图] Pod 的Annotation 信息的更新，处理服务健康检查、服务上下线等情况并实时更新本地缓存。整体流程仅使用 Kubernetes 原生 API 完成将 Kubernetes 作为注册中心的功能特性。

这个方案非常简洁，不需要实现额外的第三方模块，也不需要对 Dubbo 业务作出改动，仅仅把 k8s 当做部署平台，依赖其容器管理能力，没有使用其 label selector 和 service 等服务治理特性。如果站在 k8s Operator 的角度来看，Operator 方案的优点即 Endpoint 方案的缺点，Endpoint 方案无法使用 k8s 的健康检查能力，亦没有使用 k8s service 的事件监听能力，每个 consumer 冗余监听一些不必要监听的事件，当 Endpoint 过多时会加大 API Server 的网络压力。

Dubbo Java 2.7.5 功能解析

Mon, 18 May 2020 00:00:00 +0000

近日，备受瞩目的 Dubbo 2.7.5 版本正式发布，在 2.7.5 版本中，Dubbo 引入了很多新的特性、对现有的很多功能做了增强、同时在性能上也有了非常大的提升，这个版本无论对 Dubbo 社区亦或是开发者来说，都将是一个里程碑式的版本。

应用粒度服务注册【beta】
HTTP/2 (gRPC) 协议支持
Protobuf 支持
性能优化，调用链路性能提升 30%
支持 TLS 安全传输链路
优化的消费端线程模型
新增更适应多集群部署场景的负载均衡策略
全新的应用开发 API （兼容老版本应用）【beta】
其他一些功能增强与 bugfix

首先，从服务发现上，新版本突破以往基于接口粒度的模型，引入了全新的基于应用粒度的服务发现机制 - 服务自省，虽然该机制当前仍处于 beta 阶段，但对于 Dubbo 向整个微服务云原生体系靠齐，都打下了非常好的基础；得益于紧凑的协议设计和代码实现上的优化，Dubbo 一直以来都具有较好的性能表现，在 2.7.5 版本中，性能上有了进一步的提升，根据来自官方维护团队的压测，新版本在调用链路上性能提升达到 30%；云原生微服务时代，多语言需求变得越来越普遍，协议的通用性和穿透性对于构建打通前后端的整套微服务体系也变得非常关键，Dubbo 通过实现 gRPC 协议实现了对 HTTP/2 协议的支持，同时增加了与 Protobuf 的结合。

1. 应用粒度服务注册【beta】

从 Java 实现版本的角度来说，Dubbo 是一个面向接口代理的服务开发框架，服务定义、服务发布以及服务引用都是基于接口，服务治理层面包括服务发现、各种规则定义也都是基于接口定义的，基于接口可以说是 Dubbo 的一大优势，比如向开发者屏蔽了远程调用细节、治理粒度更精细等。但基于接口的服务定义同时也存在一些问题，如服务，与业界通用的微服务体系等。

针对以上问题，2.7.5 版本引入了一种新的服务定义/治理机制：服务自省，简单来说这是一种基于应用粒度的服务治理方案。一个实例只向注册中心注册一条记录，彻底解决服务推送性能瓶颈，同时由于这样的模型与主流微服务体系如 SpringCloud、K8S 等天然是对等的，因此为 Dubbo 解决和此类异构体系间的互联互通清除了障碍。有兴趣进一步了解 Dubbo 服务自省机制如何解决异构微服务体系互联互通问题的，可具体参考我们之前的文章解析《Dubbo 如何成为联通异构微服务体系的最佳服务开发框架》。

以下是服务自省机制的基本工作原理图。

要了解更多关于服务自省工作原理的细节，请参与官方文档及后续文章。

服务自省与当前已有的机制之间可以说是互补的关系，Dubbo 框架会继续保持接口粒度的服务治理的优势，实现接口和应用两个粒度互为补充的局面，兼顾性能、灵活性和通用性，力争使 Dubbo 成为微服务开发的最佳框架。