Dubbo 整合 ZooKeeper 實戰：從環境搭建到服務治理平台部署

技術棧版本

• JDK 1.7.0_79
• ZooKeeper 3.4.5
• Tomcat 7.0
• Dubbo Admin 2.5.3 (管理控制台)
• Maven 3.2.5
• Dubbo 官方文檔：https://dubbo.io/Home-zh.htm

關鍵步驟

1. ZooKeeper 安裝部署

1. 解壓至 D:\zookeeper-3.4.5
2. 重命名 conf\zoo_sample.cfg → zoo.cfg（默認配置即可）
3. 運行 bin\zkServer.cmd 啟動
4. 出現 Mode: standalone 表示成功

2. Dubbo Admin 管理控制台部署

1. 解壓 dubbo-admin-2.5.3.war
2. 清空 Tomcat webapps\ROOT 目錄，將解壓文件複製進去
3. 修改 WEB-INF\dubbo.properties 配置註冊中心地址：
   dubbo.registry.address=zookeeper://127.0.0.1:2181
4. 啟動 Tomcat，瀏覽器訪問 https://localhost:8080/
5. 默認賬號：root/root、guest/guest

3. 服務提供者/消費者項目結構

• dubbo-provider：暴露服務接口實現，註冊到 ZooKeeper
• dubbo-consumer：引用遠程服務，通過代理調用
• 公共接口模塊打包 JAR 供雙方依賴

4. 核心配置示例

提供者 applicationContext-provider.xml

<dubbo:application name="demo-provider"/>
<dubbo:registry address="zookeeper://127.0.0.1:2181"/>
<dubbo:protocol name="dubbo" port="20880"/>
<dubbo:service interface="com.demo.api.UserService" ref="userServiceImpl"/>
<bean id="userServiceImpl" class="com.demo.provider.UserServiceImpl"/>

消費者 applicationContext-consumer.xml

<dubbo:application name="demo-consumer"/>
<dubbo:registry address="zookeeper://127.0.0.1:2181"/>
<dubbo:reference id="userService" interface="com.demo.api.UserService"/>

啟動順序

1. ZooKeeper (zkServer.cmd)
2. Tomcat (部署 Dubbo Admin)
3. Provider 項目 (主類啟動或部署至 Tomcat)
4. Consumer 項目 (主類啟動或部署至 Tomcat)

驗證成功

• Dubbo Admin 控制台「服務治理」頁面顯示 UserService 提供者/消費者在線
• Consumer 調用 userService.getUser(1) 返回正確數據
• 控制台輸出無錯誤堆棧

源碼下載

• Provider：dubbo-provider
• Consumer：dubbo-consumer

常見問題

• 端口衝突：Dubbo 協議默認 20880，多實例需配置不同端口
• 版本不匹配：API 接口 JAR 版本需提供者/消費者一致
• 序列化異常：實體類實現 Serializable，serialVersionUID 保持一致
• 防火牆/網絡：確保 2181(ZK)、20880(Dubbo) 端口互通