【Dubbo】配置详解 --标签、配置项、使用建议

àì夳堔傛蜴生んèń 2023-01-07 13:24 246阅读 0赞

> Dubbo 官网：[https://dubbo.apache.org/zh/docs][https_dubbo.apache.org_zh_docs]

## 1.标签 ##

<table> 
 <thead> 
  <tr> 
   <th align="left"><strong>标签</strong></th> 
   <th align="left"><strong>用途</strong></th> 
   <th align="left"><strong>解释</strong></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left"><code>&lt;dubbo:application/&gt;</code></td> 
   <td align="left">公共</td> 
   <td align="left">用于配置当前应用信息，不管该应用是提供者还是消费者</td> 
  </tr> 
  <tr> 
   <td align="left"><code>&lt;dubbo:registry/&gt;</code></td> 
   <td align="left">公共</td> 
   <td align="left">用于配置连接注册中心相关信息</td> 
  </tr> 
  <tr> 
   <td align="left"><code>&lt;dubbo:protocol/&gt;</code></td> 
   <td align="left">Provider</td> 
   <td align="left">用于配置提供服务的协议信息，协议由提供方指定，消费方被动接受</td> 
  </tr> 
  <tr> 
   <td align="left"><code>&lt;dubbo:service/&gt;</code></td> 
   <td align="left">Provider</td> 
   <td align="left">用于暴露一个服务，定义服务的元信息，<br>一个服务可以用多个协议暴露，一个服务也可以注册到多个注册中心</td> 
  </tr> 
  <tr> 
   <td align="left"><code>&lt;dubbo:provider/&gt;</code></td> 
   <td align="left">Provider</td> 
   <td align="left">当 ProtocolConfig 和 ServiceConfig 某属性没有配置时，采用此缺省值，可选</td> 
  </tr> 
  <tr> 
   <td align="left"><code>&lt;dubbo:consumer/&gt;</code></td> 
   <td align="left">Consumer</td> 
   <td align="left">当 ReferenceConfig 某属性没有配置时，采用此缺省值，可选</td> 
  </tr> 
  <tr> 
   <td align="left"><code>&lt;dubbo:reference/&gt;</code></td> 
   <td align="left">Consumer</td> 
   <td align="left">用于创建一个远程服务代理，一个引用可以指向多个注册中心</td> 
  </tr> 
  <tr> 
   <td align="left"><code>&lt;dubbo:method/&gt;</code></td> 
   <td align="left">公共</td> 
   <td align="left">用于 ServiceConfig 和 ReferenceConfig 指定方法级的配置信息</td> 
  </tr> 
  <tr> 
   <td align="left"><code>&lt;dubbo:argument/&gt;</code></td> 
   <td align="left">公共</td> 
   <td align="left">用于指定方法参数配置</td> 
  </tr> 
 </tbody> 
</table>

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzkzNTkyNw_size_16_color_FFFFFF_t_70_pic_center][]

## 2.标签配置项 ##

我们可以在官网的[这里][Link 1]查到所有标签的配置项

![在这里插入图片描述][20210118020718991.png_pic_center]  
所有配置项分为三大类

1.  服务发现：表示该配置项用于服务的注册与发现，目的是让消费方找到提供方。
2.  服务治理：表示该配置项用于治理服务间的关系，或为开发测试提供便利条件。
3.  性能调优：表示该配置项用于调优性能，不同的选项对性能会产生影响。

我们下面来看看最核心的两个：`<dubbo:provider>` 和 `<dubbo:consumer>`。

### 2.1 dubbo:provider ###

服务提供者缺省值配置。对应的配置类： `org.apache.dubbo.config.ProviderConfig`。

> PS：该标签为 `<dubbo:service>` 和 `<dubbo:protocol>` 标签的缺省值设置。

<table> 
 <thead> 
  <tr> 
   <th>属性</th> 
   <th>对应URL参数</th> 
   <th>类型</th> 
   <th>是否必填</th> 
   <th>缺省值</th> 
   <th>作用</th> 
   <th>描述</th> 
   <th>兼容性</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>id</td> 
   <td></td> 
   <td>string</td> 
   <td>可选</td> 
   <td>dubbo</td> 
   <td>配置关联</td> 
   <td>协议BeanId，可以在&lt;dubbo:service proivder=""&gt;中引用此ID</td> 
   <td>1.0.16以上版本</td> 
  </tr> 
  <tr> 
   <td>protocol</td> 
   <td></td> 
   <td>string</td> 
   <td>可选</td> 
   <td>dubbo</td> 
   <td>性能调优</td> 
   <td>协议名称</td> 
   <td>1.0.16以上版本</td> 
  </tr> 
  <tr> 
   <td>host</td> 
   <td></td> 
   <td>string</td> 
   <td>可选</td> 
   <td>自动查找本机IP</td> 
   <td>服务发现</td> 
   <td>服务主机名，多网卡选择或指定VIP及域名时使用，为空则自动查找本机IP，建议不要配置，让Dubbo自动获取本机IP</td> 
   <td>1.0.16以上版本</td> 
  </tr> 
  <tr> 
   <td>threads</td> 
   <td>threads</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>200</td> 
   <td>性能调优</td> 
   <td>服务线程池大小(固定大小)</td> 
   <td>1.0.16以上版本</td> 
  </tr> 
  <tr> 
   <td>payload</td> 
   <td>payload</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>8388608(=8M)</td> 
   <td>性能调优</td> 
   <td>请求及响应数据包大小限制，单位：字节</td> 
   <td>2.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>path</td> 
   <td> </td> 
   <td>string</td> 
   <td>可选</td> 
   <td></td> 
   <td>服务发现</td> 
   <td>提供者上下文路径，为服务path的前缀</td> 
   <td>2.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>server</td> 
   <td>server</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>dubbo协议缺省为netty，http协议缺省为servlet</td> 
   <td>性能调优</td> 
   <td>协议的服务器端实现类型，比如：dubbo协议的mina,netty等，http协议的jetty,servlet等</td> 
   <td>2.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>client</td> 
   <td>client</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>dubbo协议缺省为netty</td> 
   <td>性能调优</td> 
   <td>协议的客户端实现类型，比如：dubbo协议的mina,netty等</td> 
   <td>2.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>codec</td> 
   <td>codec</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>dubbo</td> 
   <td>性能调优</td> 
   <td>协议编码方式</td> 
   <td>2.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>serialization</td> 
   <td>serialization</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>dubbo协议缺省为hessian2，rmi协议缺省为java，http协议缺省为json</td> 
   <td>性能调优</td> 
   <td>协议序列化方式，当协议支持多种序列化方式时使用，比如：dubbo协议的dubbo,hessian2,java,compactedjava，以及http协议的json,xml等</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>default</td> 
   <td></td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td>false</td> 
   <td>配置关联</td> 
   <td>是否为缺省协议，用于多协议</td> 
   <td>1.0.16以上版本</td> 
  </tr> 
  <tr> 
   <td>filter</td> 
   <td>service.filter</td> 
   <td>string</td> 
   <td>可选</td> 
   <td></td> 
   <td>性能调优</td> 
   <td>服务提供方远程调用过程拦截器名称，多个名称用逗号分隔</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>listener</td> 
   <td>exporter.listener</td> 
   <td>string</td> 
   <td>可选</td> 
   <td></td> 
   <td>性能调优</td> 
   <td>服务提供方导出服务监听器名称，多个名称用逗号分隔</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>threadpool</td> 
   <td>threadpool</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>fixed</td> 
   <td>性能调优</td> 
   <td>线程池类型，可选：fixed/cached/limit(2.5.3以上)/eager(2.6.x以上)</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>accepts</td> 
   <td>accepts</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>0</td> 
   <td>性能调优</td> 
   <td>服务提供者最大可接受连接数</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>version</td> 
   <td>version</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>0.0.0</td> 
   <td>服务发现</td> 
   <td>服务版本，建议使用两位数字版本，如：1.0，通常在接口不兼容时版本号才需要升级</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>group</td> 
   <td>group</td> 
   <td>string</td> 
   <td>可选</td> 
   <td></td> 
   <td>服务发现</td> 
   <td>服务分组，当一个接口有多个实现，可以用分组区分</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>delay</td> 
   <td>delay</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>0</td> 
   <td>性能调优</td> 
   <td>延迟注册服务时间(毫秒)- ，设为-1时，表示延迟到Spring容器初始化完成时暴露服务</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>timeout</td> 
   <td>default.timeout</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>1000</td> 
   <td>性能调优</td> 
   <td>远程服务调用超时时间(毫秒)</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>retries</td> 
   <td>default.retries</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>2</td> 
   <td>性能调优</td> 
   <td>远程服务调用重试次数，不包括第一次调用，不需要重试请设为0</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>connections</td> 
   <td>default.connections</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>0</td> 
   <td>性能调优</td> 
   <td>对每个提供者的最大连接数，rmi、http、hessian等短连接协议表示限制连接数，dubbo等长连接协表示建立的长连接个数</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>loadbalance</td> 
   <td>default.loadbalance</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>random</td> 
   <td>性能调优</td> 
   <td>负载均衡策略，可选值：random,roundrobin,leastactive，分别表示：随机，轮询，最少活跃调用</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>async</td> 
   <td>default.async</td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td>false</td> 
   <td>性能调优</td> 
   <td>是否缺省异步执行，不可靠异步，只是忽略返回值，不阻塞执行线程</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>stub</td> 
   <td>stub</td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td>false</td> 
   <td>服务治理</td> 
   <td>设为true，表示使用缺省代理类名，即：接口名 + Local后缀。</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>mock</td> 
   <td>mock</td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td>false</td> 
   <td>服务治理</td> 
   <td>设为true，表示使用缺省Mock类名，即：接口名 + Mock后缀。</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>token</td> 
   <td>token</td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td>false</td> 
   <td>服务治理</td> 
   <td>令牌验证，为空表示不开启，如果为true，表示随机生成动态令牌</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>registry</td> 
   <td>registry</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>缺省向所有registry注册</td> 
   <td>配置关联</td> 
   <td>向指定注册中心注册，在多个注册中心时使用，值为<code>&lt;dubbo:registry&gt;</code>的id属性，多个注册中心ID用逗号分隔，如果不想将该服务注册到任何registry，可将值设为N/A</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>dynamic</td> 
   <td>dynamic</td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td>true</td> 
   <td>服务治理</td> 
   <td>服务是否动态注册，如果设为false，注册后将显示后disable状态，需人工启用，并且服务提供者停止时，也不会自动取消册，需人工禁用。</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>accesslog</td> 
   <td>accesslog</td> 
   <td>string/boolean</td> 
   <td>可选</td> 
   <td>false</td> 
   <td>服务治理</td> 
   <td>设为true，将向logger中输出访问日志，也可填写访问日志文件路径，直接把访问日志输出到指定文件</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>owner</td> 
   <td>owner</td> 
   <td>string</td> 
   <td>可选</td> 
   <td></td> 
   <td>服务治理</td> 
   <td>服务负责人，用于服务治理，请填写负责人公司邮箱前缀</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>document</td> 
   <td>document</td> 
   <td>string</td> 
   <td>可选</td> 
   <td></td> 
   <td>服务治理</td> 
   <td>服务文档URL</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>weight</td> 
   <td>weight</td> 
   <td>int</td> 
   <td>可选</td> 
   <td></td> 
   <td>性能调优</td> 
   <td>服务权重</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>executes</td> 
   <td>executes</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>0</td> 
   <td>性能调优</td> 
   <td>服务提供者每服务每方法最大可并行执行请求数</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>actives</td> 
   <td>default.actives</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>0</td> 
   <td>性能调优</td> 
   <td>每服务消费者每服务每方法最大并发调用数</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>proxy</td> 
   <td>proxy</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>javassist</td> 
   <td>性能调优</td> 
   <td>生成动态代理方式，可选：jdk/javassist</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>cluster</td> 
   <td>default.cluster</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>failover</td> 
   <td>性能调优</td> 
   <td>集群方式，可选：failover/failfast/failsafe/failback/forking</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>deprecated</td> 
   <td>deprecated</td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td>false</td> 
   <td>服务治理</td> 
   <td>服务是否过时，如果设为true，消费方引用时将打印服务过时警告error日志</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>queues</td> 
   <td>queues</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>0</td> 
   <td>性能调优</td> 
   <td>线程池队列大小，当线程池满时，排队等待执行的队列大小，建议不要设置，当线程池满时应立即失败，重试其它服务提供机器，而不是排队，除非有特殊需求。</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>charset</td> 
   <td>charset</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>UTF-8</td> 
   <td>性能调优</td> 
   <td>序列化编码</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>buffer</td> 
   <td>buffer</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>8192</td> 
   <td>性能调优</td> 
   <td>网络读写缓冲区大小</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>iothreads</td> 
   <td>iothreads</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>CPU + 1</td> 
   <td>性能调优</td> 
   <td>IO线程池，接收网络读写中断，以及序列化和反序列化，不处理业务，业务线程池参见threads配置，此线程池和CPU相关，不建议配置。</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>telnet</td> 
   <td>telnet</td> 
   <td>string</td> 
   <td>可选</td> 
   <td></td> 
   <td>服务治理</td> 
   <td>所支持的telnet命令，多个命令用逗号分隔</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td><code>&lt;dubbo:service&gt;</code></td> 
   <td>contextpath</td> 
   <td>contextpath</td> 
   <td>String</td> 
   <td>可选</td> 
   <td>缺省为空串</td> 
   <td>服务治理</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>layer</td> 
   <td>layer</td> 
   <td>string</td> 
   <td>可选</td> 
   <td></td> 
   <td>服务治理</td> 
   <td>服务提供者所在的分层。如：biz、dao、intl:web、china:acton。</td> 
   <td>2.0.7以上版本</td> 
  </tr> 
 </tbody> 
</table>

### 2.2 dubbo:consumer ###

服务消费者缺省值配置。配置类：`org.apache.dubbo.config.ConsumerConfig`。

> PS：该标签为 `<dubbo:reference>` 标签的缺省值设置。

<table> 
 <thead> 
  <tr> 
   <th>属性</th> 
   <th>对应URL参数</th> 
   <th>类型</th> 
   <th>是否必填</th> 
   <th>缺省值</th> 
   <th>作用</th> 
   <th>描述</th> 
   <th>兼容性</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>timeout</td> 
   <td>default.timeout</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>1000</td> 
   <td>性能调优</td> 
   <td>远程服务调用超时时间(毫秒)</td> 
   <td>1.0.16以上版本</td> 
  </tr> 
  <tr> 
   <td>retries</td> 
   <td>default.retries</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>2</td> 
   <td>性能调优</td> 
   <td>远程服务调用重试次数，不包括第一次调用，不需要重试请设为0,仅在cluster为failback/failover时有效</td> 
   <td>1.0.16以上版本</td> 
  </tr> 
  <tr> 
   <td>loadbalance</td> 
   <td>default.loadbalance</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>random</td> 
   <td>性能调优</td> 
   <td>负载均衡策略，可选值：random,roundrobin,leastactive，分别表示：随机，轮询，最少活跃调用</td> 
   <td>1.0.16以上版本</td> 
  </tr> 
  <tr> 
   <td>async</td> 
   <td>default.async</td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td>false</td> 
   <td>性能调优</td> 
   <td>是否缺省异步执行，不可靠异步，只是忽略返回值，不阻塞执行线程</td> 
   <td>2.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>connections</td> 
   <td>default.connections</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>100</td> 
   <td>性能调优</td> 
   <td>每个服务对每个提供者的最大连接数，rmi、http、hessian等短连接协议支持此配置，dubbo协议长连接不支持此配置</td> 
   <td>1.0.16以上版本</td> 
  </tr> 
  <tr> 
   <td>generic</td> 
   <td>generic</td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td>false</td> 
   <td>服务治理</td> 
   <td>是否缺省泛化接口，如果为泛化接口，将返回GenericService</td> 
   <td>2.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>check</td> 
   <td>check</td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td>true</td> 
   <td>服务治理</td> 
   <td>启动时检查提供者是否存在，true报错，false忽略</td> 
   <td>1.0.16以上版本</td> 
  </tr> 
  <tr> 
   <td>proxy</td> 
   <td>proxy</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>javassist</td> 
   <td>性能调优</td> 
   <td>生成动态代理方式，可选：jdk/javassist</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>owner</td> 
   <td>owner</td> 
   <td>string</td> 
   <td>可选</td> 
   <td></td> 
   <td>服务治理</td> 
   <td>调用服务负责人，用于服务治理，请填写负责人公司邮箱前缀</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>actives</td> 
   <td>default.actives</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>0</td> 
   <td>性能调优</td> 
   <td>每服务消费者每服务每方法最大并发调用数</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>cluster</td> 
   <td>default.cluster</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>failover</td> 
   <td>性能调优</td> 
   <td>集群方式，可选：failover/failfast/failsafe/failback/forking</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>filter</td> 
   <td>reference.filter</td> 
   <td>string</td> 
   <td>可选</td> 
   <td></td> 
   <td>性能调优</td> 
   <td>服务消费方远程调用过程拦截器名称，多个名称用逗号分隔</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>listener</td> 
   <td>invoker.listener</td> 
   <td>string</td> 
   <td>可选</td> 
   <td></td> 
   <td>性能调优</td> 
   <td>服务消费方引用服务监听器名称，多个名称用逗号分隔</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>registry</td> 
   <td></td> 
   <td>string</td> 
   <td>可选</td> 
   <td>缺省向所有registry注册</td> 
   <td>配置关联</td> 
   <td>向指定注册中心注册，在多个注册中心时使用，值为<code>&lt;dubbo:registry&gt;</code>的id属性，多个注册中心ID用逗号分隔，如果不想将该服务注册到任何registry，可将值设为N/A</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>layer</td> 
   <td>layer</td> 
   <td>string</td> 
   <td>可选</td> 
   <td></td> 
   <td>服务治理</td> 
   <td>服务调用者所在的分层。如：biz、dao、intl:web、china:acton。</td> 
   <td>2.0.7以上版本</td> 
  </tr> 
  <tr> 
   <td>init</td> 
   <td>init</td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td>false</td> 
   <td>性能调优</td> 
   <td>是否在afterPropertiesSet()时饥饿初始化引用，否则等到有人注入或引用该实例时再初始化。</td> 
   <td>2.0.10以上版本</td> 
  </tr> 
  <tr> 
   <td>cache</td> 
   <td>cache</td> 
   <td>string/boolean</td> 
   <td>可选</td> 
   <td></td> 
   <td>服务治理</td> 
   <td>以调用参数为key，缓存返回结果，可选：lru, threadlocal, jcache等</td> 
   <td>Dubbo2.1.0及其以上版本支持</td> 
  </tr> 
  <tr> 
   <td>validation</td> 
   <td>validation</td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td></td> 
   <td>服务治理</td> 
   <td>是否启用JSR303标准注解验证，如果启用，将对方法参数上的注解进行校验</td> 
   <td>Dubbo2.1.0及其以上版本支持</td> 
  </tr> 
 </tbody> 
</table>

## 3.使用建议 ##

### 3.1 两个套路 ###

**套路一**：使用缺省配置标签

如果需要暴露多个服务的时候，每个服务都要设置其超时时间，貌似有点繁琐。Dubbo中可以通过 `<dubbo:provider>` 来实现服务端缺省配置。它可以同时为 `<dubbo:service>` 和 `<dubbo:protocol>` 两个标签提供缺省配置。

比如：`<dubbo:provider timeout="2000" retries="2"></dubbo:provider>` 相当于每个服务提供者设置了超时时间和重试次数。这些缺省设置可以配置多个通过 `<dubbo:service provider="providerId">`，如果没指定就用第一个。

同样客户端也有缺省配置标签：`<dubbo:consumer>`。

**套路二**：多标签同一配置项的优先级问题

在服务端配置 timeout 之后，所有客户端都会采用该方超时时间，其客户端可以自定义超时时间吗？通过 `<dubbo:reference timeout="2000">` 可以设定，或者在`<dubbo:consumer timeout="2000">` 也可以设定，甚至可以设定到方法级别 `<dubbo:method name="getUser" timeout="2000"/>`。

加上服务端的配置，超时总共有6处可以配置。如果6处都配置了不同的值，最后肯定只会有一个超时值生效，其优先级如下：

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzkzNTkyNw_size_16_color_FFFFFF_t_70_pic_center 1]

### 3.2 配置示例 ###

Provider：

<dubbo:application name="demo-provider"/>
    <dubbo:registry protocol="zookeeper" address="127.0.0.1:2181" check="true"/>
    <dubbo:protocol name="dubbo" port="20880"/>
    
    <dubbo:provider group="xupt.yzh.demo"
                    threadpool="fixed"
                    threads="500"
                    timeout="5000"
                    retries="2"/>
    
    <dubbo:service interface="com.xupt.yzh.demo.service.DemoService"
                   timeout="5000"
                   retries="1"
                   version="3.0.0"
                   ref="demoService"/>
    
    <bean id="demoService" class="com.xupt.yzh.demo.service.DemoServiceImpl"/>

Consumer：

<dubbo:application name="demo-consumer"/>
    <dubbo:registry protocol="zookeeper" address="127.0.0.1:2181" check="true"/>
    
    <dubbo:consumer timeout="5000" retries="2"
                    group="xupt.yzh.demo"
                    version="1.0.0"/>
                    
    <dubbo:reference
            timeout="3000" retries="1"
            id="demoService"
            version="*"
            interface="com.xupt.yzh.demo.service.DemoService"/>

[https_dubbo.apache.org_zh_docs]: https://dubbo.apache.org/zh/docs
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzkzNTkyNw_size_16_color_FFFFFF_t_70_pic_center]: /images/20221119/976b04464154443ea1744c211b974a87.png
[Link 1]: https://dubbo.apache.org/zh/docs/v2.7/user/references/xml/
[20210118020718991.png_pic_center]: https://img-blog.csdnimg.cn/20210118020718991.png#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzkzNTkyNw_size_16_color_FFFFFF_t_70_pic_center 1]: https://img-blog.csdnimg.cn/20210118015201134.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzkzNTkyNw==,size_16,color_FFFFFF,t_70#pic_center