正确设置dubbo timeout

正确设置dubbo timeout

• 目的和意义

为了规范地、透明地、合理地使用 dubbo timeout 功能。

当前存在部分 dubbo 服务，无论是提供者或消费者，都没有明确的超时机制，大多数的服务是使用配置中心默认的超时时间 10000ms=10s；10s的超时时间对于大多数接口来说没有意义，通常来说，一个用户在点击某个页面或功能按钮之后，如果 10s 还没有返回结果，大多数用户都会放弃本次操作。

• 设置途径

  • **consumer：**第一优先级，在 consumer 端配置超时时间

    <dubbo:reference id="documentCenterPlugService" interface="[cn.gov](http://cn.gov/).zcy.dc.plug.service.DocumentCenterPlugService" retries="0" timeout="2000" version="1.0.0"/>

  • **provider：**第二优先级，在 provider 端配置超时时间

    <dubbo:service interface="[cn.gov](http://cn.gov/).zcy.dc.plug.service.DocumentCenterPlugService" class="[cn.gov](http://cn.gov/).zcy.dc.plug.service.DocumentCenterPlugServiceImpl" timeout="2000" version="1.0.0"/>

  • **default：**配置中心全局默认 timeout=10000ms（即将更改为 3000ms ），如果 consumer 和 provider 都没有设置超时时间，将采用配置中心配置的默认超时时间，前提是使用cn.gov.zcy.boot:spring-boot-starter-dubbo 该组件集成 dubbo。

  • [扩展] 方法级timeout配置优先级最高

    <dubbo:reference id=“documentCenterPlugService” interface=“cn.gov.zcy.dc.plug.service.DocumentCenterPlugService” retries=“0” timeout=“2000” version=“1.0.0”>
    <dubbo:method name=“getDownLoadUrl” timeout=“2500”/>
    </dubbo:reference>

配置优先顺序，请参考dubbo配置覆盖关系

注意事项：

• 读服务允许重试，但写服务请不要设置重试，同时重试机制要重点review；
• 每个服务消费者 consumer 必须配置 timeout ；
• 提供者有义务告知消费者 timeout 参考值范围，可以细化到方法级 timeout；