Dubbo原理剖析之 @DubboReference.version设置为*

Dubbo版号通配符

最新推荐文章于 2025-10-07 01:41:34 发布

原创最新推荐文章于 2025-10-07 01:41:34 发布 · 2.7k 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#Dubbo #Nacos #Zookeeper

微服务架构同时被 3 个专栏收录

10 篇文章

订阅专栏

Dubbo

8 篇文章

订阅专栏

Zookeeper

4 篇文章

订阅专栏

本文解析了Dubbo框架中使用通配符(*)指定消费者版本号的功能，探讨了Zookeeper与Nacos作为注册中心时的实现差异。

1 背景

Dubbo在消费端提供了一个功能，即将消费者的版本号指定为*，那么不管服务端的接口版本是啥，都可以调用成功。

2 初步猜测：

dubbo接口定位逻辑：接口(全路径)+服务分组(group字段)+版本号(version字段)。

Zookeeper 是用树状来保存数据的，在 Zookeeper 中，可以利用Dubbo接口(全路径)作为父节点，再根据group和version信息写入子节点。

而 Nacos，在 Nacos 的控制台中，我们看到可以根据服务名或服务分组来模糊查询服务列表，那么在消费者订阅的时候，就根据这两个模糊查询就可以了，查出来的健康提供者都是符合的。

下面就深入一下源码，看看实际的逻辑是不是类似我们的猜想。

3 源码剖析

3.1 Zookeeper 作为注册中心

3.1.1 准备：

弄一个服务提供者、一个服务消费者。服务提供者对外提供一个dubbo接口，版本有1.0.0和2.0.0；服务消费者引入服务提供者提供的dubbo接口，version设置为*。

启动服务提供者、接着启动消费者，观察后台日志打印：

我们可以看到，当我们将@DubboReference的version设置为*的时候，他就根据注册url(带*)去找有哪些服务提供者，然后返回的urls会有多个，其中包含版本号为1.0.0和2.0.0的url。

2021-05-01 10:24:08.561 [main] [INFO ] [o.a.d.r.z.ZookeeperRegistry] [] [] -  [DUBBO] Subscribe: consumer://127.0.0.1/com.winfun.service.DubboServiceOne?application=dubbo-service&category=providers,configurators,routers&dubbo=2.0.2&init=false&interface=com.winfun.service.DubboServiceOne&methods=sayHello&pid=14021&qos.enable=false&reference.filter=default,dubboLogFilter,sentinel.dubbo.consumer.filter&release=2.7.7&revision=*&side=consumer&sticky=false&timestamp=1619835848549&version=*, dubbo version: 2.7.7, current host: 127.0.0.1
2021-05-01 10:24:08.572 [main] [INFO ] [o.a.d.r.z.ZookeeperRegistry] [] [] -  [DUBBO] Notify urls for subscribe url consumer://127.0.0.1/com.winfun.service.DubboServiceOne?application=dubbo-service&category=providers,configurators,routers&dubbo=2.0.2&init=false&interface=com.winfun.service.DubboServiceOne&methods=sayHello&pid=14021&qos.enable=false&reference.filter=default,dubboLogFilter,sentinel.dubbo.consumer.filter&release=2.7.7&revision=*&side=consumer&sticky=false&timestamp=1619835848549&version=*, urls: [dubbo://192.168.2.10:20880/com.winfun.service.DubboServiceOne?anyhost=true&application=dubbo-provider-one&deprecated=false&dubbo=2.0.2&dynamic=true&generic=false&interface=com.winfun.service.DubboServiceOne&metadata-type=remote&methods=sayHello&pid=13996&release=2.7.8&revision=1.0.0&service.filter=default,dubboLogFilter&side=provider&timestamp=1619835820516&version=1.0.0, dubbo://192.168.2.10:20880/com.winfun.service.DubboServiceOne?anyhost=true&application=dubbo-provider-one&deprecated=false&dubbo=2.0.2&dynamic=true&generic=false&interface=com.winfun.service.DubboServiceOne&metadata-type=remote&methods=sayHello&pid=13996&release=2.7.8&revision=2.0.0&service.filter=default,dubboLogFilter&side=provider&timestamp=1619835820187&version=2.0.0, empty://127.0.0.1/com.winfun.service.DubboServiceOne?application=dubbo-service&category=configurators&dubbo=2.0.2&init=false&interface=com.winfun.service.DubboServiceOne&methods=sayHello&pid=14021&qos.enable=false&reference.filter=default,dubboLogFilter,sentinel.dubbo.consumer.filter&release=2.7.7&revision=*&side=consumer&sticky=false&timestamp=1619835848549&version=*, empty://127.0.0.1/com.winfun.service.DubboServiceOne?application=dubbo-service&category=routers&dubbo=2.0.2&init=false&interface=com.winfun.service.DubboServiceOne&methods=sayHello&pid=14021&qos.enable=false&reference.filter=default,dubboLogFilter,sentinel.dubbo.consumer.filter&release=2.7.7&revision=*&side=consumer&sticky=false&timestamp=1619835848549&version=*], dubbo version: 2.7.7, current host: 127.0.0.1

3.1.2 源码分析

上面我们看到，version=*可以成功订阅，并且服务提供者有两个，分别是version=1.0.0和version=2.0.0。
结果是看得出来了，但是我们还是需要看看Zookeeper是怎么的判断逻辑。

3.1.2.1 服务消费者订阅过程

我们都知道，正常发布Dubbo的消费者，需要配置ReferenceConfig，然后调用export方法；当然了，我们这里就不过于深入了，直接从日志的入口来开始：org.apache.dubbo.registry.zookeeper.ZookeeperRegistry#doSubscribe

我们服务消费者的订阅url：

consumer://127.0.0.1/com.winfun.service.DubboServiceOne?application=dubbo-service&category=providers,configurators,routers&dubbo=2.0.2&init=false&interface=com.winfun.service.DubboServiceOne&methods=sayHello&pid=16215&qos.enable=false&reference.filter=default,dubboLogFilter,sentinel.dubbo.consumer.filter&release=2.7.7&revision=*&side=consumer&sticky=false&timestamp=1619842106726&version=*

第一步：获取dubbo接口全路径

url.getServiceInterface() -> com.winfun.service.DubboServiceOne

接着判断是否等于“*”，明显不是，跳到else分支

第二步：根据url获取path

获取根节点:

toCategoriesPath(url) -> /dubbo/com.winfun.service.DubboServiceOne/providers、/dubbo/com.winfun.service.DubboServiceOne/configurators、/dubbo/com.winfun.service.DubboServiceOne/consumers

第三步：遍历第二步的path、创建父节点

重点在path=/dubbo/com.winfun.service.DubboServiceOne/providers，其他忽略即可

根据path创建节点（非持久化）：zkClient.create(root, false);

给path添加子节点监听器： zkClient.addChildListener(path, zkListener) 并返回子节点列表

dubbo://192.168.2.10:20880/com.winfun.service.DubboServiceOne?anyhost=true&application=dubbo-provider-one&deprecated=false&dubbo=2.0.2&dynamic=true&generic=false&interface=com.winfun.service.DubboServiceOne&metadata-type=remote&methods=sayHello&pid=13996&release=2.7.8&revision=1.0.0&service.filter=default,dubboLogFilter&side=provider&timestamp=1619835820516&version=1.0.0
dubbo://192.168.2.10:20880/com.winfun.service.DubboServiceOne?anyhost=true&application=dubbo-provider-one&deprecated=false&dubbo=2.0.2&dynamic=true&generic=false&interface=com.winfun.service.DubboServiceOne&metadata-type=remote&methods=sayHello&pid=13996&release=2.7.8&revision=2.0.0&service.filter=default,dubboLogFilter&side=provider&timestamp=1619835820187&version=2.0.0

configurators 和 consumers 不存在子节点，所以子节点是根据规则生成的url，前缀为empty

第四步：对上面获取到的urls进行监听

调用org.apache.dubbo.registry.support.FailbackRegistry#notify方法。

最后会去到 org.apache.dubbo.registry.support.AbstractRegistry#notify(org.apache.dubbo.common.URL, org.apache.dubbo.registry.NotifyListener, java.util.List<org.apache.dubbo.common.URL>)

重点：在监听前，会先匹配根据path查询的所有子节点中，匹配符合当前消费者的子节点（根据group和version判断），利用org.apache.dubbo.common.utils.UrlUtils#isMatch判断。

判断中最重要的逻辑：

String ANY_VALUE = "*";

String consumerGroup = consumerUrl.getParameter(GROUP_KEY);
String consumerVersion = consumerUrl.getParameter(VERSION_KEY);
String consumerClassifier = consumerUrl.getParameter(CLASSIFIER_KEY, ANY_VALUE);

String providerGroup = providerUrl.getParameter(GROUP_KEY);
String providerVersion = providerUrl.getParameter(VERSION_KEY);
String providerClassifier = providerUrl.getParameter(CLASSIFIER_KEY, ANY_VALUE);
return (ANY_VALUE.equals(consumerGroup) || StringUtils.isEquals(consumerGroup, providerGroup) || StringUtils.isContains(consumerGroup, providerGroup))
        && (ANY_VALUE.equals(consumerVersion) || StringUtils.isEquals(consumerVersion, providerVersion))
        && (consumerClassifier == null || ANY_VALUE.equals(consumerClassifier) || StringUtils.isEquals(consumerClassifier, providerClassifier));

上面完全可以体现出：当版本号等于*号，dubbo接口根节点下的服务都会作为当前消费者的服务提供者。

好了，到这里，我们可以知道Zookeeper是怎么为version=*的消费者订阅服务的，直接根据接口全路径名到Zookeeper里获取所有子节点，并都可以作为服务提供者。

其实这里会有一个扩展点：多个服务提供者，调用的时候是怎么负载的，其实在@DubboReference中的loadbance属性中看得出，默认的负载策略是随机。

/**
 * Load balance strategy, legal values include: random, roundrobin, leastactive
 * <p>
 * see Constants#DEFAULT_LOADBALANCE
 */
String loadbalance() default "";

org.apache.dubbo.common.constants.CommonConstants#DEFAULT_LOADBALANCE="random";

3.1.2.2 服务消费者执行过程

proxy执行入口：

我们可以通过debug模式，进入到Dubbo方法执行的入口：org.apache.dubbo.rpc.proxy.InvokerInvocationHandler#invoke

第一步：初步判断

如果是 Object类或者 toString、destory、hashCode等方法，直接执行

第二步：创建RpcInvocation

根据执行方法、参数等信息创建RpcInvocation
获取serviceKey：-> serviceKey = dubbo-api-path/group:version
RpcInvocation设置TargetServiceUniqueName

第三步：调用invoker的invoke方法

来到org.apache.dubbo.rpc.cluster.support.wrapper.MockClusterInvoker#invoke
判断是否设置了 mock 或 force

如果是调用org.apache.dubbo.rpc.cluster.support.wrapper.MockClusterInvoker#doMockInvoke方法
否则来到org.apache.dubbo.rpc.cluster.support.wrapper.AbstractCluster.InterceptorInvokerNode#invoke

第四步：AbstractClusterInvoker#invoke

调用AbstractClusterInvoker#list获取invoker列表，可以看到拿到的就是1.0.0版本和2.0.0版本的服务提供者

接着调用 initLoadBalance 方法来初始化负载均衡策略，从订阅url里面获取loadbalance的值，如果没有设置，返回默认值“random”

/**
 * Init LoadBalance.
 * <p>
 * if invokers is not empty, init from the first invoke's url and invocation
 * if invokes is empty, init a default LoadBalance(RandomLoadBalance)
 * </p>
 *
 * @param invokers   invokers
 * @param invocation invocation
 * @return LoadBalance instance. if not need init, return null.
 */
protected LoadBalance initLoadBalance(List<Invoker<T>> invokers, Invocation invocation) {
    if (CollectionUtils.isNotEmpty(invokers)) {
        return ExtensionLoader.getExtensionLoader(LoadBalance.class).getExtension(invokers.get(0).getUrl()
                .getMethodParameter(RpcUtils.getMethodName(invocation), LOADBALANCE_KEY, DEFAULT_LOADBALANCE));
    } else {
        return ExtensionLoader.getExtensionLoader(LoadBalance.class).getExtension(DEFAULT_LOADBALANCE);
    }
}

第五步：根据集群策略执行方法

由于Dubbo默认的集群策略是 failover，所以会来到来到：org.apache.dubbo.rpc.cluster.support.FailoverClusterInvoker#doInvoker

首先会从注册url里面的retries字段获取重试次数（如果为空，默认重试次数为2），此次取的是默认值，所以最后最大调用次数为3.

循环retries+1次

来到：org.apache.dubbo.rpc.cluster.support.AbstractClusterInvoker#select 选择Invoker
- 下一步：org.apache.dubbo.rpc.cluster.support.AbstractClusterInvoker#doSelect
- 下一步：org.apache.dubbo.rpc.cluster.loadbalance.AbstractLoadBalance#select
- 由于默认是random的负载均衡策略，所以最后来到：org.apache.dubbo.rpc.cluster.loadbalance.RandomLoadBalance#doSelect
在RandomLoadBalance#doSelect 中，首先会根据服务提供者的权重判断，如果权重没赋值，最后会利用ThreadLocalRandom.current().nextInt(invokers.size())随机选择一个invoker。
执行invoke方法，返回结果
如果有错误，记录着，下次循环打印warn日志
如果超过retries+1次调用失败，往外抛出RpcException异常

到这里，我们已经非常清楚Zookeeper 是如何支持消费者将 version设置为*，并且方法调用时是如何选择服务提供者。

3.2 Nacos 作为注册中心

3.2.1 准备：

弄一个服务提供者、一个服务消费者，这次不再是Zookeeper作为注册中心，而是Nacos作为注册中心。服务提供者对外提供一个dubbo接口，版本有1.0.0和2.0.0；服务消费者引入服务提供者提供的dubbo接口，version设置为*。

启动服务提供者、接着启动消费者，观察后台日志打印：

3.2.2 源码分析

3.2.2.1 服务消费者订阅过程

Nacos 源码分析也是直接从 NacosRegistry#doSubscribe 入口开始
：
org.apache.dubbo.registry.nacos.NacosRegistry#doSubscribe(org.apache.dubbo.common.URL, org.apache.dubbo.registry.NotifyListener)

消费者的注册url：

consumer://192.168.3.3/com.winfun.service.DubboServiceOne?application=dubbo-consumer-nacos&category=providers,configurators,routers&dubbo=2.0.2&init=false&interface=com.winfun.service.DubboServiceOne&metadata-type=remote&methods=sayHello&pid=39203&qos.enable=false&reference.filter=default,dubboLogFilter&release=2.7.8&revision=*&side=consumer&sticky=false&timestamp=1620177626113&version=*

第一步、根据url获取serviceName集合：

org.apache.dubbo.registry.nacos.NacosRegistry#getServiceNames0

1 创建 NacosServiceName：

providers:com.winfun.service.DubboServiceOne:*:

2 接着到：org.apache.dubbo.registry.nacos.NacosRegistry#filterServiceNames(org.apache.dubbo.registry.nacos.NacosServiceName)

根据上面的servicename过滤出所有的serviceName

2.1 先利用NamingProxy查询：
com.alibaba.nacos.client.naming.net.NamingProxy#getServiceList(int, int, java.lang.String, com.alibaba.nacos.api.selector.AbstractSelector)

利用接口全路径名+group查询，没有带版本号

2.2 最后到：com.alibaba.nacos.common.http.client.NacosRestTemplate#exchangeForm
http 请求：
url：http://127.0.0.1:8848/nacos/v1/ns/service/list
params：{app=unknown, pageSize=2147483647, groupName=DEFAULT_GROUP, namespaceId=public, pageNo=1}

返回结果：
RestResult{code=200, message=‘null’, data={“doms”:[“providers:com.winfun.service.DubboServiceOne:1.0.0:”,“providers:com.winfun.service.DubboServiceOne:2.0.0:”],“count”:2}}

明显包含两个版本的service

第二步、根据条件过滤合适的 service

public boolean isCompatible(NacosServiceName concreteServiceName) {

    if (!concreteServiceName.isConcrete()) { // The argument must be the concrete NacosServiceName
        return false;
    }

    // Not match comparison
    if (!StringUtils.isEquals(this.category, concreteServiceName.category)
            && !matchRange(this.category, concreteServiceName.category)) {
        return false;
    }

    if (!StringUtils.isEquals(this.serviceInterface, concreteServiceName.serviceInterface)) {
        return false;
    }

    // wildcard condition
    // 重点在这里
    if (isWildcard(this.version)) {
        return true;
    }

    if (isWildcard(this.group)) {
        return true;
    }

    // range condition
    if (!StringUtils.isEquals(this.version, concreteServiceName.version)
            && !matchRange(this.version, concreteServiceName.version)) {
        return false;
    }

    if (!StringUtils.isEquals(this.group, concreteServiceName.group) &&
            !matchRange(this.group, concreteServiceName.group)) {
        return false;
    }

    return true;
}

private boolean isWildcard(String value) {
    return WILDCARD.equals(value);
}

public static final String WILDCARD = "*";

过滤后的 service 有两个，分别是1.0.0和2.0.0

那么继续深一步的订阅流程：org.apache.dubbo.registry.nacos.NacosRegistry#doSubscribe(org.apache.dubbo.common.URL, org.apache.dubbo.registry.NotifyListener, java.util.Set<java.lang.String>)

第三步、遍历serviceNames，根据serviceName+group查询所有实例列表并且进行实例监听

List<Instance> instances = new LinkedList<>();
for (String serviceName : serviceNames) {
    instances.addAll(namingService.getAllInstances(serviceName
            , getUrl().getParameter(GROUP_KEY, Constants.DEFAULT_GROUP)));
    notifySubscriber(url, listener, instances);
    subscribeEventListener(serviceName, url, listener);
}

到这里，整个订阅流程已经结束，主要是看version=*如何判断哪些服务实例可提供服务，再深入的就没有了。

Nacos 作为注册中心，查询服务实例主要是根据 serviceName(接口全路径名)和group(分组)，这是因为Nacos的数据结构本身主要的就是服务名+分组名。
在这里插入图片描述

3.2.2.2 服务消费者调用过程

这个就不再深入讲解了，调用过程和 Zookeeper 上基本一致。

总结&彩蛋

到这里，我们就可以捋清楚不同的注册中心是如何支持@DubboReference.version设置为*的；当然了，Dubbo 除了 Zookeeper、Nacos 可以作为注册中心，Redis 也是可以的，至于其中原理估计也类似，主要是看 Dubbo 如何利用 Redis 提供的数据结构做文章。

但是我们可以发现，我们上面的例子，服务提供者的所有对外提供的服务都是带版本号的；但是其实在我们的项目中，大部分项目是不带版本号的；那么这里会有一个疑问：如果服务提供者只提供了不带版本号的接口，那么消费者将版本号设置为*还可以正常使用么？

这里我可以先告诉大家，启动时没问题的，根据我们上面的分析，不管是Nacos还是Zooleeper，在订阅的时候都可以找到不带版本号的服务：

2021-05-07 11:13:20.702 [main] [INFO ] [o.a.d.r.z.ZookeeperRegistry] [] [] -  [DUBBO] Subscribe: consumer://172.26.156.9/com.winfun.service.DubboServiceOne?application=dubbo-service&category=providers,configurators,routers&dubbo=2.0.2&init=false&interface=com.winfun.service.DubboServiceOne&metadata-type=remote&methods=sayHello&pid=13134&qos.enable=false&reference.filter=default,dubboLogFilter,sentinel.dubbo.consumer.filter&release=2.7.8&revision=*&side=consumer&sticky=false&timestamp=1620357200041&version=*, dubbo version: 2.7.8, current host: 172.26.156.9
2021-05-07 11:13:20.722 [main] [INFO ] [o.a.d.r.z.ZookeeperRegistry] [] [] -  [DUBBO] Notify urls for subscribe url consumer://172.26.156.9/com.winfun.service.DubboServiceOne?application=dubbo-service&category=providers,configurators,routers&dubbo=2.0.2&init=false&interface=com.winfun.service.DubboServiceOne&metadata-type=remote&methods=sayHello&pid=13134&qos.enable=false&reference.filter=default,dubboLogFilter,sentinel.dubbo.consumer.filter&release=2.7.8&revision=*&side=consumer&sticky=false&timestamp=1620357200041&version=*, urls: [dubbo://172.26.156.9:20880/com.winfun.service.DubboServiceOne?anyhost=true&application=dubbo-provider-one&deprecated=false&dubbo=2.0.2&dynamic=true&generic=false&interface=com.winfun.service.DubboServiceOne&metadata-type=remote&methods=sayHello&pid=13117&release=2.7.8&service.filter=default,dubboLogFilter&side=provider&timestamp=1620357151537, empty://172.26.156.9/com.winfun.service.DubboServiceOne?application=dubbo-service&category=configurators&dubbo=2.0.2&init=false&interface=com.winfun.service.DubboServiceOne&metadata-type=remote&methods=sayHello&pid=13134&qos.enable=false&reference.filter=default,dubboLogFilter,sentinel.dubbo.consumer.filter&release=2.7.8&revision=*&side=consumer&sticky=false&timestamp=1620357200041&version=*, empty://172.26.156.9/com.winfun.service.DubboServiceOne?application=dubbo-service&category=routers&dubbo=2.0.2&init=false&interface=com.winfun.service.DubboServiceOne&metadata-type=remote&methods=sayHello&pid=13134&qos.enable=false&reference.filter=default,dubboLogFilter,sentinel.dubbo.consumer.filter&release=2.7.8&revision=*&side=consumer&sticky=false&timestamp=1620357200041&version=*], dubbo version: 2.7.8, current host: 172.26.156.9

但是到了服务调用的时候，就会报错了：

org.apache.dubbo.remoting.RemotingException: Not found exported service: com.winfun.service.DubboServiceOne:*:20880 in [com.winfun.service.DubboServiceOne:20880], may be version or group mismatch , channel: consumer: /172.26.156.9:55595 --> provider: /172.26.156.9:20880, message:RpcInvocation [methodName=sayHello, parameterTypes=[class java.lang.String], arguments=[], attachments={input=323, path=com.winfun.service.DubboServiceOne, remote.application=dubbo-service, trace_id=162035690727995149419, dubboApplication=dubbo-service, dubbo=2.0.2, interface=com.winfun.service.DubboServiceOne, version=*, uri=/more/version/hello/v2/winfun}]

至于为什么到了服务调用的时候就报错，我们这里就不再深入研究了，有机会的话交给下一篇文章～