Apache Dubbo 配置参数详解

Dubbo 的配置项按作用域可分为：应用级（application）、协议级（protocol）、注册中心级（registry）、方法/服务级（provider / consumer）以及运维级（QoS）。本文以 dubbo 3.2.20 为准，逐项说明常用参数的取值、默认值与含义。文中的默认值可在服务运行后通过 QoS 控制台的 getConfig 命令回显核对，实测示例：

<dubbo:application enableFileCache="true" executorManagementMode="isolation" parameters="{}" name="dubbo-demo-provider" protocol="dubbo" />
<dubbo:protocol preferSerialization="fastjson2,hessian2" port="20880" name="dubbo" />
<dubbo:registry port="0" address="N/A" />

一、配置方式与优先级

Dubbo 支持四种等价配置方式，覆盖优先级由高到低通常为：API 配置 > 注解 > XML/YAML 配置文件 > dubbo.properties。同一参数多处配置时，粒度更细者优先（方法级 > 接口级 > 全局级）。

1.1 四种配置方式对照

1.2 属性命名转换规则

XML 中的 camelCase 参数在 YAML/properties 中转为 kebab-case。例如 preferSerialization 在 YAML 中写作 prefer-serialization，executorManagementMode 写作 executor-management-mode。

二、应用级配置（dubbo.application.*）

2.1 核心参数

2.2 示例

dubbo:
  application:
    name: dubbo-demo-provider
    qos-enable: true
    qos-port: 22222
    register-mode: all

三、协议配置（dubbo.protocol.*）

3.1 核心参数

3.2 序列化选择说明

• hessian2：Dubbo 协议默认的二进制序列化，跨语言、体积小、兼容性好，是生产默认值；
• fastjson2：JSON 文本序列化，便于排查报文，但在 3.2 中作为优先项之一参与协商；
• 多协议/多序列化可并存，由两端按 prefer-serialization 顺序协商。

3.3 示例

dubbo:
  protocol:
    name: dubbo
    port: 20880
    serialization: hessian2
    threads: 200
    threadpool: fixed
    heartbeat: 60000

四、注册中心配置（dubbo.registry.*）

4.1 核心参数

4.2 直连模式

无需注册中心时，将地址设为 N/A（对应常量 RegistryConfig.NO_AVAILABLE），provider 直接暴露、consumer 通过 url 直接连接：

dubbo:
  registry:
    address: N/A

五、服务端与客户端参数（dubbo.provider.* / dubbo.consumer.*）

5.1 超时与重试

5.2 负载均衡

5.3 服务端/客户端其他常用项

5.4 示例

dubbo:
  provider:
    timeout: 3000
    retries: 2
    loadbalance: random
  consumer:
    timeout: 3000
    retries: 2
    check: false

六、QoS 运维端口配置

QoS（Quality of Service）控制台是 Dubbo 自 2.5.8 起内置的运维命令行，默认监听 22222，可通过 telnet 或 TCP 直连使用。

实测端口监听（ss -lntp）：

LISTEN 0      4096               *:20880            *:*    users:(("java",pid=5366,fd=186))
LISTEN 0      4096               *:22222            *:*    users:(("java",pid=5366,fd=157))

生产环境若不希望暴露运维端口，可设置 qos-enable: false，或仅允许本机 127.0.0.1 接入。

七、线程池与序列化配置

7.1 线程池

Dubbo 默认使用 fixed 类型线程池，业务线程数由 threads 控制，线程池管理模型由 executor-management-mode 控制：

7.2 序列化

7.3 JVM 堆建议

Dubbo 本身不常驻大量堆内存，建议为运行进程设置合理的堆上限，示例：-Xms256m -Xmx512m。

八、参数速查表