Kazoo：Python 操作 ZooKeeper 的利器
Kazoo 是一个基于 Python 的 ZooKeeper 客户端库，它对 ZooKeeper 提供了高级封装，让开发者可以方便地在 Python 程序中连接、操作、监听 ZooKeeper 节点。
ZooKeeper 是一个流行的分布式协调服务，常用于实现配置管理、命名服务、分布式锁、主节点选举等功能，是构建分布式系统的基础组件之一。
✅ 什么时候使用 Kazoo？
如果你在开发 Python 分布式系统，遇到以下需求，就可以考虑使用 Kazoo：
- 需要连接 ZooKeeper 做协调或状态同步
- 实现分布式锁、服务注册与发现、主备选举等机制
- 想监听节点或子节点的变化，做事件驱动处理
- 需要对 ZooKeeper 的节点进行增删改查（CRUD）操作
Kazoo 提供简洁的 API 和完善的事件监听机制，帮助开发者解决分布式系统中常见的状态一致性、节点协调等问题。
🧰 安装 Kazoo
直接使用 pip 安装：
pip install kazoo
🔗 连接 ZooKeeper
from kazoo.client import KazooClient
# 实例化客户端，填写 ZooKeeper 地址和端口（默认 2181）
zk = KazooClient(hosts='127.0.0.1:2181')
# 启动连接
zk.start()
# 停止连接
zk.stop()
如需权限认证，可设置 auth_data：
zk = KazooClient(
hosts='127.0.0.1:2181',
auth_data=[("digest", "user:password")]
)
📁 节点的增删改查操作
创建节点
# 类似 mkdir -p，确保路径存在
zk.ensure_path("/my/favorite")
# 创建节点（注意：value 必须是 bytes 类型）
zk.create("/my/favorite/node", b"a value", ephemeral=False, sequence=False)
参数说明：
ephemeral=True：创建临时节点，断开连接后自动删除sequence=True：创建顺序节点，系统自动在节点名后加编号
读取节点
data, stat = zk.get("/my/favorite/node")
print("版本号:", stat.version, "内容:", data.decode("utf-8"))
获取子节点列表
children = zk.get_children("/my/favorite")
print("子节点列表:", children)
修改节点数据
zk.set("/my/favorite/node", b"new data")
删除节点
# recursive=True 表示递归删除子节点
zk.delete("/my/favorite/node", recursive=True)
👂 Watch：监听机制
Kazoo 支持对节点或子节点变化进行监听，变化发生时会触发回调函数。
示例：监听某个节点的数据变化
from kazoo.client import KazooClient
import time
zk = KazooClient(hosts='127.0.0.1:2181')
zk.start()
@zk.DataWatch("/my/favorite/node")
def watch_node(data, stat, event=None):
if data:
print(f"节点内容变了，当前内容：{data.decode('utf-8')}, 版本：{stat.version}")
else:
print("节点已被删除或不存在")
# 保持程序运行
while True:
time.sleep(10)
示例：监听子节点变化
@zk.ChildrenWatch("/my/favorite")
def watch_children(children):
print(f"子节点变化了，当前列表：{children}")
📶 监听连接状态
连接 ZooKeeper 时可能会遇到掉线、重连、会话过期等情况，Kazoo 提供了连接状态监听机制：
from kazoo.client import KazooClient
from kazoo.protocol.states import KazooState
def my_listener(state):
if state == KazooState.LOST:
print("会话丢失，可能需要重新注册")
elif state == KazooState.SUSPENDED:
print("连接中断")
else:
print("连接恢复")
zk = KazooClient(hosts='127.0.0.1:2181')
zk.add_listener(my_listener)
zk.start()
💡 典型应用场景
- 分布式锁：使用临时顺序节点，实现排他访问控制
- 配置中心：统一管理配置，变化后实时通知各服务节点
- 服务注册与发现：服务上线时注册节点，客户端监听获取服务列表
- 任务队列：通过顺序节点实现简单的分布式任务调度
🧾 总结
Kazoo 是 Python 语言中连接和操作 ZooKeeper 的高效工具，功能强大、使用方便。通过它，你可以轻松实现节点的增删改查、事件监听、分布式锁等核心功能，非常适合构建高可用、易扩展的分布式系统。
如果你在做分布式架构相关的 Python 项目，Kazoo 值得一试。
如需深入学习，可以参考这些文章：
