推荐用法

在 Provider 上尽量多配置 Consumer 端属性

原因如下：

  • 作服务的提供者，比服务使用方更清楚服务性能参数，如调用的超时时间，合理的重试次数，等等
  • 在 Provider 配置后，Consumer 不配置则会使用 Provider 的配置值，即 Provider 配置可以作为 Consumer 的缺省值 [^1]。否则，Consumer 会使用 Consumer 端的全局设置，这对于 Provider 不可控的，并且往往是不合理的
    Provider 上尽量多配置 Consumer 端的属性，让 Provider 实现者一开始就思考 Provider 服务特点、服务质量的问题。

示例：

  1. <dubbo:service interface="com.alibaba.hello.api.HelloService" version="1.0.0" ref="helloService"
  2.     timeout="300" retry="2" loadbalance="random" actives="0"
  3. />
  5. <dubbo:service interface="com.alibaba.hello.api.WorldService" version="1.0.0" ref="helloService"
  6.     timeout="300" retry="2" loadbalance="random" actives="0" >
  7.     <dubbo:method name="findAllPerson" timeout="10000" retries="9" loadbalance="leastactive" actives="5" />
  8. <dubbo:service/>

在 Provider 上可以配置的 Consumer 端属性有：

  • timeout 方法调用超时
  • retries 失败重试次数，缺省是 2 [^2]
  • loadbalance 负载均衡算法 [^3]，缺省是随机 random。还可以有轮询 roundrobin、最不活跃优先 [^4] leastactive
  • actives 消费者端，最大并发调用限制，即当 Consumer 对一个服务的并发调用到上限后，新调用会 Wait 直到超时在方法上配置 dubbo:method 则并发限制针对方法，在接口上配置 dubbo:service，则并发限制针对服务
    详细配置说明参见：Dubbo配置参考手册

Provider 上配置合理的 Provider 端属性

  1. <dubbo:protocol threads="200" /> 
  2. <dubbo:service interface="com.alibaba.hello.api.HelloService" version="1.0.0" ref="helloService"
  3.     executes="200" >
  4.     <dubbo:method name="findAllPerson" executes="50" />
  5. </dubbo:service>

Provider 上可以配置的 Provider 端属性有：

  • threads 服务线程池大小
  • executes 一个服务提供者并行执行请求上限，即当 Provider 对一个服务的并发调用到上限后，新调用会 Wait，这个时候 Consumer可能会超时。在方法上配置 dubbo:method 则并发限制针对方法，在接口上配置 dubbo:service，则并发限制针对服务

    配置管理信息

目前有负责人信息和组织信息用于区分站点。有问题时便于的找到服务的负责人，至少写两个人以便备份。负责人和组织的信息可以在注册中心的上看到。

应用配置负责人、组织：

  1. <dubbo:application owner=”ding.lid,william.liangf” organization=”intl” />

service 配置负责人：

  1. <dubbo:service owner=”ding.lid,william.liangf” />

reference 配置负责人：

  1. <dubbo:reference owner=”ding.lid,william.liangf” />

dubbo:service、dubbo:reference 没有配置负责人，则使用 dubbo:application 设置的负责人。

配置 Dubbo 缓存文件

提供者列表缓存文件：

  1. <dubbo:registry file=”${user.home}/output/dubbo.cache” />

注意：

  • 文件的路径，应用可以根据需要调整，保证这个文件不会在发布过程中被清除。
  • 如果有多个应用进程注意不要使用同一个文件，避免内容被覆盖。
    这个文件会缓存注册中心的列表和服务提供者列表。有了这项配置后，当应用重启过程中，Dubbo 注册中心不可用时则应用会从这个缓存文件读取服务提供者列表的信息，进一步保证应用可靠性。

监控配置

  • 使用固定端口暴露服务，而不要使用随机端口

这样在注册中心推送有延迟的情况下，消费者通过缓存列表也能调用到原地址，保证调用成功。

  • 使用 Dragoon 的 http 监控项监控注册中心上服务提供方

Dragoon 监控服务在注册中心上的状态：http://dubbo-reg1.hst.xyi.cn.alidc.net:8080/status/com.alibaba.morgan.member.MemberService:1.0.5 确保注册中心上有该服务的存在。

  • 服务提供方，使用 Dragoon 的 telnet 或 shell 监控项

监控服务提供者端口状态：echo status | nc -i 1 20880 | grep OK | wc -l，其中的 20880 为服务端口

  • 服务消费方，通过将服务强制转型为 EchoService，并调用 $echo() 测试该服务的提供者是可用

如 assertEqauls(“OK”, ((EchoService)memberService).$echo(“OK”));

不要使用 dubbo.properties 文件配置，推荐使用对应 XML 配置

Dubbo 中所有的配置项都可以配置在 Spring 配置文件中，并且可以针对单个服务配置。

如完全不配置则使用 Dubbo 缺省值，参见 Dubbo配置参考手册 中的说明。

dubbo.properties 中属性名与 XML 的对应关系

  • 应用名 dubbo.application.name
  • 注册中心地址 dubbo.registry.address
  • 调用超时 dubbo.service.*.timeout

可以在多个配置项设置超时 timeout，由上至下覆盖（即上面的优先）[^5]，其它的参数（retries、loadbalance、actives等）的覆盖策略也一样示例如下：

提供者端特定方法的配置



提供者端特定接口的配置

  • 服务提供者协议 dubbo.service.protocol、服务的监听端口 dubbo.service.server.port


<dubbo:protocol name="dubbo" port="20880" />

  1.     
  2. 5. 服务线程池大小 `dubbo.service.max.thread.threads.size`
  4.     ```xml
  5.     <dubbo:protocol threads="100" />
  6.     ```
  8. 6. 消费者启动时，没有提供者是否抛异常 Fast-Fail `alibaba.intl.commons.dubbo.service.allow.no.provider`
  10.     ```xml
  11.     <dubbo:reference interface="com.alibaba.xxx.XxxService" check="false" />
  12.     ```
  14. [^1]: 配置的覆盖规则：1) 方法级别配置优于接口级别，即小 Scope 优先 2) Consumer 端配置优于 Provider 配置，优于全局配置，最后是Dubbo 硬编码的配置值（[Dubbo 配置参考手册](./configuration/properties.md#覆盖策略)）
  15. [^2]: 表示加上第一次调用，会调用 3 次
  16. [^3]: 有多个 Provider 时，如何挑选 Provider 调用
  17. [^4]: 指从 Consume r端并发调用最好的 Provider，可以减少的反应慢的 Provider 的调用，因为反应更容易累积并发的调用
  18. [^5]: `timeout` 可以在多处设置，配置项及覆盖规则详见： [Dubbo 配置参考手册](./references/xml/introduction.md)

原文: http://dubbo.apache.org/#!/docs/user/recommend.md?lang=zh-cn