Dubbo在开发中的一些常用配置

Posted 2021-01-08 雪山上的蒲公英

介绍Dubbo在开发中的一些常用配置，文中内容主要参考dubbo文档配置和示例两节，详细可移步访问  传送站

1. 属性配置方法及加载顺序

属性常用配置方法主要有三种：

第一种是通过启动时在虚拟机参数中加上相关信息

第二种也是最常用的是通过xml方式配置，随着springboot和dubbo的集成，这种方式在springboot项目中表现为通过application.properties来配置，两者优先级相同；

第三种是在classpath 根目录下的创建 dubbo.properties，dubbo启动时，如果没有其他配置文件，会自动加载该配置。

2. 启动检查

Dubbo 缺省会在启动时检查依赖的服务是否可用，不可用时会抛出异常，阻止 Spring 初始化完成，以便上线时，能及早发现问题，默认 check="true"。

可在xml和properties文件中进行配置，以显式关闭启动检查

<!-- 关闭所有服务的启动时检查 (没有提供者时报错) -->
<dubbo:consumer check="false" />

dubbo.consumer.check=false

3. 超时设置 & 配置覆盖关系

由于网络或服务端不可靠，会导致调用出现一种不确定的中间状态（超时）。为了避免超时导致客户端资源（线程）挂起耗尽，必须设置超时时间。缺省使用<dubbo:consumer>的timeout，目前默认为1000。

Dubbo消费端

<!-- 全局超时配置 -->
<dubbo:consumer timeout="5000" />

<!-- 指定接口以及特定方法超时配置 -->
<dubbo:reference interface="com.foo.BarService" timeout="2000">
    <dubbo:method name="sayHello" timeout="3000" />
</dubbo:reference>

Dubbo服务端

<!-- 全局超时配置 -->
<dubbo:provider timeout="5000" />

<!-- 指定接口以及特定方法超时配置 -->
<dubbo:provider interface="com.foo.BarService" timeout="2000">
    <dubbo:method name="sayHello" timeout="3000" />
</dubbo:provider>

通过上面的配置，我们可能产生疑惑，如果多方都配置了属性，那么会以哪个为准？这就涉及到配置覆盖关系

以 timeout 为例，显示了配置的查找顺序，其它 retries, loadbalance, actives 等类似：

• 方法级优先，接口级次之，全局配置再次之。
• 如果级别一样，则消费方优先，提供方次之。

其中，服务提供方配置，通过 URL 经由注册中心传递给消费方。

建议由服务提供方设置超时，因为一个方法需要执行多长时间，服务提供方更清楚，如调用的超时时间，合理的重试次数，等等；如果一个消费方同时引用多个服务，就不需要关心每个服务的超时设置。另外，在服务提供方配置后，消费方不配置则会使用服务提供方的配置值，即服务提供方配置可以作为消费方的缺省值。否则，消费方会使用消费方的全局设置，这对于服务提供方是不可控的，并且往往是不合理的。

4. 重试次数

失败自动切换，当出现失败，重试其它服务器，但重试会带来更长延迟。可通过 retries="2" 来设置重试次数(不含第一次)。

<!--针对服务提供方 -->
<dubbo:service retries="2" />
<!-- 针对服务消费方 -->
<dubbo:reference retries="2" />
<!-- 针对方法 -->
<dubbo:reference>
    <dubbo:method name="findFoo" retries="2" />
</dubbo:reference>

5. 多版本

当一个接口实现，出现不兼容升级时，可以用版本号过渡，版本号不同的服务相互间不引用。

可以按照以下的步骤进行版本迁移：

0. 在低压力时间段，先升级一半提供者为新版本
1. 再将所有消费者升级为新版本
2. 然后将剩下的一半提供者升级为新版本

老版本服务提供者配置：

<dubbo:service interface="com.foo.BarService" version="1.0.0" />

新版本服务提供者配置：

<dubbo:service interface="com.foo.BarService" version="2.0.0" />

老版本服务消费者配置：

<dubbo:reference id="barService" interface="com.foo.BarService" version="1.0.0" />

新版本服务消费者配置：

<dubbo:reference id="barService" interface="com.foo.BarService" version="2.0.0" />

如果不需要区分版本，可以按照以下的方式配置：

<dubbo:reference id="barService" interface="com.foo.BarService" version="*" />

6. 本地存根

远程服务后，客户端通常只剩下接口，而实现全在服务器端，但提供方有些时候想在客户端也执行部分逻辑，比如：做 ThreadLocal 缓存，提前验证参数，调用失败后伪造容错数据等等，此时就需要在 API 中带上 Stub，客户端生成 Proxy 实例，会把 Proxy 通过构造函数传给 Stub ，然后把 Stub 暴露给用户，Stub 可以决定要不要去调 Proxy。

服务提供方（服务消费方也可配置）

<dubbo:service interface="com.foo.BarService" stub="com.foo.BarServiceStub" />

业务逻辑放在Stub类中实现

package com.foo;
public class BarServiceStub implements BarService { 
    private final BarService barService;
    
    // 构造函数传入真正的远程代理对象
    public (BarService barService) {
        this.barService = barService;
    }
 
    public String sayHello(String name) {
        // 此代码在客户端执行, 你可以在客户端做ThreadLocal本地缓存，或预先验证参数是否合法，等等
        try {
            return barService.sayHello(name);
        } catch (Exception e) {
            // 你可以容错，可以做任何AOP拦截事项
            return "容错数据";
        }
    }
}