带你读《Apache Dubbo微服务开发从入门到精通》——六、 配置项手册（7）

属性

对应URL参数

类型

是否必填

缺省值

作用

描述

兼容性

timeout

default.timeout

int

可选

1000

性能调优

远程服务调用超时时间(毫秒)

1.0.16以上版本

retries

default.retries

int

可选

2

性能调优

远程服务调用重试次数，不包括第一次调用，不需要重试请设为0,仅在cluster为failback/failover时有效

1.0.16以上版本

loadbalance

default.loadbalance

string

可选

random

性能调优

负载均衡策略，可选值： * random - 随机; * roundrobin - 轮询; * leastactive - 最少活跃调用; * consistenthash - 哈希一致 (2.1.0以上版本); * shortestresponse - 最短响应 (2.7.7以上版本);

1.0.16以上版本

async

default.async

boolean

可选

false

性能调优

是否缺省异步执行，不可靠异步，只是忽略返回值，不阻塞执行线程

2.0.0以上版本

sent

default.sent

boolean

可选

true

服务治理

异步调用时，标记sent=true时，表示网络已发出数据

2.0.6以上版本

connections

default.connections

int

可选

100

性能调优

每个服务对每个提供者的最大连接数，rmi、http、hessian等短连接协议支持此配置，dubbo协议长连接不支持此配置

1.0.16以上版本

generic

generic

boolean

可选

false

服务治理

是否缺省泛化接口，如果为泛化接口，将返回GenericService

2.0.0以上版本

check

check

boolean

可选

true

服务治理

启动时检查提供者是否存在，true报错，false忽略

1.0.16以上版本

proxy

proxy

string

可选

javassist

性能调优

生成动态代理方式，可选：jdk/javassist

2.0.5以上版本

owner

owner

string

可选

服务治理

调用服务负责人，用于服务治理，请填写负责人公司邮箱前缀

2.0.5以上版本

actives

default.actives

int

可选

0

性能调优

每服务消费者每服务每方法最大并发调用数

2.0.5以上版本

cluster

default.cluster

string

可选

failover

性能调优

集群方式，可选：failover/failfast/failsafe/failback/forking/available/mergeable(2.1.0以上版本)/broadcast(2.1.0以上版本)/zone-aware(2.7.5以上版本)

2.0.5以上版本

filter

reference.filter

string

可选

性能调优

服务消费方远程调用过程拦截器名称，多个名称用逗号分隔

2.0.5以上版本

listener

invoker.listener

string

可选

性能调优

服务消费方引用服务监听器名称，多个名称用逗号分隔

2.0.5以上版本

registry

string

可选

缺省向所有registry注册

配置关联

向指定注册中心注册，在多个注册中心时使用，值为<dubbo:registry>的id属性，多个注册中心ID用逗号分隔，如果不想将该服务注册到任何registry，可将值设为N/A

2.0.5以上版本

layer

layer

string

可选

服务治理

服务调用者所在的分层。如：biz、dao、intl:web、china:acton。

2.0.7以上版本

init

init

boolean

可选

false

性能调优

是否在afterPropertiesSet()时饥饿初始化引用，否则等到有人注入或引用该实例时再初始化。

2.0.10以上版本

cache

cache

string/boolean

可选

服务治理

以调用参数为key，缓存返回结果，可选：lru, threadlocal, jcache等

2.1.0及其以上版本支持

validation

validation

boolean

可选

服务治理

是否启用JSR303标准注解验证，如果启用，将对方法参数上的注解进行校验

2.1.0及其以上版本支持

version

version

string

可选

服务治理

在 Dubbo 中为同一个服务配置多个版本

2.2.0及其以上版本支持

client

client

string

可选

dubbo协议缺省为netty

性能调优

协议的客户端实现类型，比如：dubbo协议的mina,netty等

2.0.0以上版本

threadpool

threadpool

string

可选

fixed

性能调优

线程池类型，可选：fixed/cached/limit(2.5.3以上)/eager(2.6.x以上)

2.0.5以上版本

corethreads

corethreads

int

可选

200

性能调优

线程池核心线程大小

2.0.5以上版本

threads

threads

int

可选

200

性能调优

服务线程池大小(固定大小)

2.0.5以上版本

queues

queues

int

可选

0

性能调优

线程池队列大小，当线程池满时，排队等待执行的队列大小，建议不要设置，当线程池满时应立即失败，重试其它服务提供机器，而不是排队，除非有特殊需求。

2.0.5以上版本

shareconnections

shareconnections

int

可选

1

性能调优

共享连接数。当connection参数设置为0时，会启用共享方式连接，默认只有一个连接。仅支持dubbo协议

2.7.0以上版本

referThreadNum

int

可选

性能优化

异步调用线程池大小

3.0.0以上版本

meshEnable

mesh-enable

boolean

可选

false

Service Mesh

Dubbo Mesh模式的开关。开启后，可适配SideCar模式，将Dubbo服务调用转换为K8S标准调用。仅支持Triple协议，兼容GRPC。设置为true后，原生对接K8S，无需第三方注册中心，设置dubbo.registry.address=N/A即可

3.1.0以上版本

parameters

parameters

Map<string, string>

可选

服务治理

扩展参数

2.0.0以上版本