Spring boot整合dubbo+zookeeper
下文將簡述springboot整合dubbo+zookeeper實現api+provider+consumer模式，Api用于定于interface,provider和consumer依賴Api,provider實現api接口，consumer調用provider。
spring boot版本：3.5.3
jdk版本：java17
1.創建父工程
此處只勾選了spring web和lombok，需要Orm框架自行增加
2.父工程引入依賴
父工程pom.xml，引入dubbo和zookeeper相關依賴，修改packaging為pom不打包，并刪除src目錄
<dependency><groupId>org.apache.dubbo</groupId><artifactId>dubbo-spring-boot-starter</artifactId><version>3.2.10</version></dependency><!-- Zookeeper客戶端 --><dependency><groupId>org.apache.curator</groupId><artifactId>curator-recipes</artifactId><version>5.2.0</version></dependency><dependency><groupId>org.apache.curator</groupId><artifactId>curator-framework</artifactId><version>5.2.0</version></dependency><dependency><groupId>org.apache.curator</groupId><artifactId>curator-x-discovery</artifactId><version>5.2.0</version> <!-- 與Zookeeper版本匹配 --></dependency><dependencyManagement><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-dependencies</artifactId><version>3.5.3</version><type>pom</type><scope>import</scope></dependency></dependencies></dependencyManagement>
3.創建api子模塊
（1）.新建dubbo-api module
（2）.修改pom.xml文件
修改dubbo-api的pom.xml,parent修改為剛才新建的groupId、artifactId和version，再去掉重復的配置
<parent><groupId>com.example</groupId><artifactId>DubboDemo</artifactId><version>0.0.1-SNAPSHOT</version></parent>
父工程pom.xml增加子模塊
<modules><module>dubbo-api</module></modules>
（ 3）.修改配置
修改application.properties為application.yml，并增加dubbo配置內容
spring:application:name: dubbo-apiconfig:activate:on-profile: default
server:port: 8080
dubbo:application:name: dubbo-apiprotocol:name: dubboport: 20880registry:address: zookeeper://192.168.48.154:2181dubbo.protocol 此處協議不是自定義的，自由dubbo、rpc等類型
registry：配置zookeeper地址
(4)啟動類，開啟dubbo，
@EnableDubbo 注解用于開啟dubbo客戶端，scanBasePackages 可以配置包路徑
@SpringBootApplication
@EnableDubbo
public class DubboApiApplication{public static void main(String[] args) {SpringApplication.run(DubboProviderApplication.class, args);}}
（5）新增Service接口
public interface TestService {String sayHello(String name);
}4.創建provider子模塊
（1）創建dubbo-provider模塊，和上面一樣，就不贅述了
（2）修改pom.xml文件
依賴中加入api模塊的依賴
<dependencies><dependency><groupId>com.example</groupId><artifactId>dubbo-api</artifactId><version>0.0.1-SNAPSHOT</version></dependency></dependencies>
（3）修改配置文件
application.yml
spring:application:name: providerconfig:activate:on-profile: default
server:port: 8081
dubbo:application:name: dubbo-providerqos-enable: trueqos-port: 22223registry:address: zookeeper://192.168.48.154:2181protocol:name: dubboport: 20881 #同一臺機器不能相同對比api模塊增加了qos-enable和qos-port兩個屬性，QoS是Dubbo提供的運維和管理功能，表示開啟；qos-port表示運維管理功能的端口
(4)啟動類，開啟dubbo，
@EnableDubbo 注解用于開啟dubbo客戶端，scanBasePackages 可以配置包路徑
@SpringBootApplication
@EnableDubbo
public class DubboProviderApplication {public static void main(String[] args) {System.setProperty("zookeeper.sasl.client", "false");SpringApplication.run(DubboProviderApplication.class, args);}}
（5）實現TestService接口
package com.examplexu.dubboprovider.service;import com.examplexu.duubo.service.TestService;
import org.apache.dubbo.config.annotation.DubboService;@DubboService(version = "1.0.0")
public class TestServiceImpl implements TestService {@Overridepublic String sayHello(String name) {return "welcome"+name+" to dubbo!";}
}@DubboService 的作用為標記TestService為服務提供者，暴露為dubbo服務，并注冊到zookeeper并進行管理。可以配置的參數如下：
version: 服務版本號(必填)
timeout: 調用超時時間(毫秒)
loadbalance: 負載均衡策略
retries: 失敗重試次數
check: 啟動時檢查依賴服務是否可用
5.創建consumer子模塊
（1）創建dubbo-consumer模塊，和上面一樣，就不贅述了
（2）修改pom.xml文件
依賴中加入api模塊的依賴
<dependencies><dependency><groupId>com.example</groupId><artifactId>dubbo-api</artifactId><version>0.0.1-SNAPSHOT</version></dependency></dependencies>
(3)修改配置文件
spring:application:name: consumerconfig:activate:on-profile: default
server:port: 8084
dubbo:config:application:name: dubbo-consumerqos-enable: trueqos-port: 22224registry:address: zookeeper://192.168.48.154:2181timeout: 20000protocol:name: dubboport: 20882config-center:timeout: 20000
此處增加了超時時間,注冊中心如果超時，會拋出異常，若配置了重試會進行重試操作；配置中心超時，會記錄警告日志，可能會影響動態配置更新
(5)啟動類，開啟dubbo
@SpringBootApplication
@EnableDubbo
public class DubboConsumerApplication {public static void main(String[] args) {System.setProperty("zookeeper.sasl.client", "false");SpringApplication.run(DubboConsumerApplication.class, args);}}
（6)增加Controller調用provider
@RestController
@RequestMapping("/consumer")
public class TestController {@DubboReference(version = "1.0.0",timeout = 5000,loadbalance = "roundrobin",retries = 3,check = false)private TestService testService;@GetMapping("/sayHello")public String test(String name) {return testService.sayHello(name);}
}
@DubboReference 用于標記引用Dubbo服務，自動從注冊中心發現并創建服務代理，實現服務的遠程調用。主要配置參數如下：
version 版本號，與服務提供者提供的version一直
timeout 單次調用超時時間
loadbalance 負載均衡策略有random/roundrobin/leastactive策略，即隨機、輪詢、近期最少使用
retries 失敗自動重試次數
check 啟動時是否檢查依賴服務的可用性
6.啟動服務
依次啟動dubbo-api、dubbo-provider、dubbo-consumer;啟動時可以查看日志會出現很多zookeeper和dubbo的日志
啟動過程中如果報錯：
2025-07-10T15:28:14.979+08:00 ERROR 37840 --- [consumer] [ main] o.a.d.c.deploy.DefaultModuleDeployer : [DUBBO] Model reference failed: Dubbo Module[1.1.1] , catch error : Can not create registry service-discovery-registry://192.168.48.154:2181/org.apache.dubbo.registry.RegistryService?application=dubbo-consumer&dubbo=2.0.2&executor-management-mode=isolation&file-cache=true&interface=org.apache.dubbo.registry.RegistryService&pid=37840&qos.enable=true&qos.port=22224®istry=zookeeper&release=3.2.10&timeout=20000, dubbo version: 3.2.10, current host: 192.168.1.93, error code: 5-15. This may be caused by , go to https://dubbo.apache.org/faq/5/15 to find instructions. java.lang.RuntimeException: Can not create registry service-discovery-registry://192.168.48.154:2181/org.apache.dubbo.registry.RegistryService?application=dubbo-consumer&dubbo=2.0.2&executor-management-mode=isolation&file-cache=true&interface=org.apache.dubbo.registry.RegistryService&pid=37840&qos.enable=true&qos.port=22224®istry=zookeeper&release=3.2.10&timeout=20000at org.apache.dubbo.registry.support.AbstractRegistryFactory.getRegistry(AbstractRegistryFactory.java:105) ~[dubbo-3.2.10.jar:3.2.10]at org.apache.dubbo.registry.RegistryFactoryWrapper.getRegistry(RegistryFactoryWrapper.java:33) ~[dubbo-3.2.10.jar:3.2.10]
啟動類中新增：
System.setProperty("zookeeper.sasl.client", "false");
表示不進行SASL認證，生產環境視要求具體設置
測試結果
當dubbo-api、dubbo-provider和dubbo-consumer都啟動完成后，使用消費者接口訪問。
可以發現此處消費者調用的是提供者的實現內容。
)
)
