前言

上文介绍了SOFA-RPC 的几种调用方式，包括单向调用、同步调用、Future调用、回调，引入了泛化调用和过滤器。本文将对 SOFA-RPC 的高级功能，包括参数配置、自定义线程池、预热权重和自动故障剔除等。

image

正文

1. 参数配置

SOFABoot RPC Starter 提供了方便的参数设置方式。这些参数目前可以分为两个部分。一部分是如端口，注册中心地址等配置，这类配置在 application.properties 中。另一部分是如超时时间等配置，这类配置在 XML 中。

XML 配置

调用超时时间

如下是设置超时时间的方式，单位为 ms ，如果调用超过了这个时间则会抛出异常。服务端和客户端都可以设置，以客户端的超时时间设置优先。默认客户端为 3000 ，目前对 bolt，rest，dubbo 生效。

获取地址等待时间

如下是设置获取地址等待时间，单位为ms。在启动时如果服务引用方等待超过了这个时间则不会再等待地址，会继续启动。客户端设置，默认为-1，表示会一直等待到地址为止。目前对 bolt，rest 生效。

建立连接超时时间

如下是设置建立连接超时时间，单位为 ms 。在建立连接时如果耗时超过了这个时间则会抛出异常。客户端设，默认为 5000。目前对 bolt，rest 生效。

权重

如下是设置权重。客户端在发起调用时，如果采用的算法是随机调用，则会根据该权重来进行随机。服务端设置，默认为 100。目前对 bolt 生效。

lazy 连接

默认情况下客户端在注册中心推送地址到客户端时，就立即建立好连接，这个过程通常是在第一次调用之前进行的。如果设置服务引用的属性 lazy 为 true，客户端在第一次调用时才和所要调用的远程地址建立连接。默认为 false。

如下设置 lazy 连接方式，将 lazy 属性设为 true。目前支持 bolt 和 dubbo 协议。

check 属性

默认情况下客户端在启动时，服务引用不要求存在可用的地址和连接。如果设置服务引用的属性 check 为 true，客户端在启动时，服务引用会检查是否存在对应的地址和连接，如果不存在会抛出异常。默认为 false。

如下设置 check 连接方式，将 check 属性设为 true。目前支持 bolt 和 dubbo 协议。

重试次数

重试次数，即在第一次调用失败后重试的最大次数，如果重试成功则不再继续重试。默认为 0。如下设置调用次数，利用 retries 属性指定重试次数。目前支持 bolt 和 dubbo 协议。

负载均衡

如下选择负载均衡的方式，利用 loadBalancer 属性指定调用时候使用的负载均衡策略，默认为 random。

目前支持 random，localPref，roundRobin，consistentHash，weightRoundRobin 五种负载均衡策略，具体可见 SOFARPC 负载均衡相关介绍。目前支持bolt协议。

方法级别配置

如下，sofa:method 元素是方法级别的配置。方法级别的配置优先级比服务级别的更高。name 属性指定了方法的名字。支持调用超时时间，调用方式，回调类的设置。方法级别的配置与服务级别的配置所生效的协议一样。

Properties 配置

属性	描述	默认值
spring.application.name	应用名
logging.path	日志路径
logging.level.com.alipay.sofa.rpc.boot	sofa-rpc-boot-start的日志级别(starter自身的日志)	info
logging.level.com.alipay.sofa.rpc	sofa-rpc的日志级别(sofa-rpc核心日志基本在这里)	info
com.alipay.sofa.rpc.bolt.port	bolt 端口	22000
com.alipay.sofa.rpc.bolt.io.thread.count	bolt 的 io 线程数
com.alipay.sofa.rpc.bolt.executor.thread.count	bolt 的业务线程最大值	200
com.alipay.sofa.rpc.bolt.accepts.count	bolt 能够支持的最大长连接数	100000
com.alipay.sofa.rpc.rest.hostname	rest 的 hostname
com.alipay.sofa.rpc.rest.port	rest 端口	8341
com.alipay.sofa.rpc.rest.io.thread.count	rest 的 io 线程数	cpu 核数 * 2
com.alipay.sofa.rpc.rest.executor.thread.count	rest 的业务线程数	200
com.alipay.sofa.rpc.rest.max.request.size	rest 的最大 byte 请求长度	1024 * 1024 * 10
com.alipay.sofa.rpc.rest.telnet	rest 是否支持 telnet	true
com.alipay.sofa.rpc.rest.daemon	rest 是否支持 daemon	true
com.alipay.sofa.rpc.dubbo.port	dubbo 的端口	20880
com.alipay.sofa.rpc.dubbo.io.thread.count	dubbo 的 io 线程数	cpu 核数 + 1
com.alipay.sofa.rpc.dubbo.executor.thread.count	dubbo 的业务线程数	100
com.alipay.sofa.rpc.dubbo.accepts.count	dubbo能够支持的最大长连接数	0，表示不限制

2. 自定义线程池

SOFA-RPC 支持自定义业务线程池。可以为指定服务设置一个独立的业务线程池，和 SOFA-RPC 自身的业务线程池是隔离的，多个服务可以共用一个独立的线程池。目前支持 bolt 协议。

在 SOFA-Boot 环境中可以为一个服务设置一个自定义线程池，配置如下：

声明自定义线程池

如下声明一个自定义线程池，class 必须为 com.alipay.sofa.rpc.server.UserThreadPool，这是 SOFA-RPC 提供的类，init-method="init" 也必须声明以进行初始化。

为服务设置自定义线程池

如下通过 sofa:global-attrs 元素的 thread-pool-ref 属性为该服务设置自定义线程池。customerThreadPool 是上面自定义线程池的 bean id。

3. 预热权重

SOFA-RPC 提供了预热权重功能让客户端机器能够根据服务端的相应权重进行流量的分发。目前支持 bolt 协议。

SOFA-Boot 中提供了一系列参数属性，对指定服务进行预热配置。客户端机器能够自动解析这些参数，并按权重进行流量分发。

warm-up-time: 服务的预热时间
warm-up-weight: 服务设置预热期间权重
weight: 服务设置预热完后的权重

上述配置中，该服务的预热期为10s，在预热期内权重为10，预热期结束后的正常权重为100。

如果该服务一共发布到A，B两个机器上。A机器正处于预热期内，使用上述配置；B已经完成预热，正常权重为200。那么客户端在调用的时候，此时流量分发的比重为10：200；A机器预热结束后，流量分发比重为100：200。

4. 自动故障剔除

自动故障剔除会自动监控 RPC 调用的情况，对故障节点进行权重降级，并在节点恢复健康时进行权重恢复。目前支持 bolt 协议。

在 SOFA-Boot 中，只需要将自动故障剔除的参数配置到 application.properties 即可。只配置自己关心的参数，其余参数会取默认值。需要注意的是，rpc.aft.regulation.effective 是该功能的全局开关，如果关闭则该功能不会运行，其他参数也都不生效。

自动故障剔除的配置参数意义

属性	描述	默认值
com.alipay.sofa.rpc.aft.time.window	时间窗口大小：对统计信息计算的周期。	10s
com.alipay.sofa.rpc.aft.least.window.count	时间窗口内最少调用数：只有在时间窗口内达到了该最低值的数据才会被加入到计算和调控中。	10次
com.alipay.sofa.rpc.aft.least.window.exception.rate.multiple	时间窗口内异常率与服务平均异常率的降级比值：在对统计信息进行计算的时候，会计算出该服务所有有效调用ip的平均异常率，如果某个ip的异常率大于等于了这个最低比值，则会被降级。	6倍
com.alipay.sofa.rpc.aft.weight.degrade.rate	降级比率：地址在进行权重降级时的降级比率。	1/20
com.alipay.sofa.rpc.aft.weight.recover.rate	恢复比率：地址在进行权重恢复时的恢复比率。	2倍
com.alipay.sofa.rpc.aft.degrade.effective	降级开关：如果应用打开了这个开关，则会对符合降级的地址进行降级，否则只会进行日志打印。	false(关闭)
com.alipay.sofa.rpc.aft.degrade.least.weight	降级最小权重：地址权重被降级后的值如果小于这个最小权重，则会以该最小权重作为降级后的值。	0
com.alipay.sofa.rpc.aft.degrade.max.ip.count	降级的最大ip数：同一个服务被降级的ip数不能超过该值。	2
com.alipay.sofa.rpc.aft.regulation.effective	全局开关：如果应用打开了这个开关，则会开启整个单点故障自动剔除摘除功能，否则完全不进入该功能的逻辑。	false(关闭)

配置示例

com.alipay.sofa.rpc.aft.time.window=20
com.alipay.sofa.rpc.aft.least.window.count=30
com.alipay.sofa.rpc.aft.least.window.exception.rate.multiple=6
com.alipay.sofa.rpc.aft.weight.degrade.rate=0.5
com.alipay.sofa.rpc.aft.weight.recover.rate=1.2
com.alipay.sofa.rpc.aft.degrade.effective=ture
com.alipay.sofa.rpc.aft.degrade.least.weight=1
com.alipay.sofa.rpc.aft.degrade.max.ip.count=2
com.alipay.sofa.rpc.aft.regulation.effective=true

上述配置中，默认打开了自动故障剔除功能和降级开关。当节点出现故障时会被进行权重降级，在恢复时会被进行权重恢复。

每隔 20s 进行一次节点健康状态的度量，20s 内调用次数超过 30 次的节点才被作为计算数据。

如果单个节点的异常率超过了所有节点的平均异常率的 6 倍，则对该节点进行权重降级，降级的比率为 0.5。权重最小降级到 1。如果单个节点的异常率低于了平均异常率的 6 倍，则对该节点进行权重恢复，恢复的比率为1.2。单个服务最多降级 2 个 IP。

小结

本文介绍了 SOFA-RPC 的高级功能，包括参数配置，自定义线程池，服务预热和自动降级与权重恢复等用法。对于 SOFA-RPC 提供的基本功能，以及整合 SOFA-Boot 的配置和用法就介绍完了。对此有了初步的认识后，有利于后续深入实现原理和剖析源码。

欢迎关注技术公众号：零壹技术栈