Ubuntu 上 Zookeeper 数据恢复实操指南
一 恢复前准备
- 确认数据目录：先查看配置文件中的 dataDir，避免覆盖错路径。命令：
grep "dataDir" /etc/zookeeper/conf/zoo.cfg。常见路径为 /var/lib/zookeeper 或 /data/zookeeper。
- 选择恢复方式：
- 全量恢复：使用先前备份的 数据目录 或 配置文件 整体还原。
- 仅配置恢复：仅覆盖 zoo.cfg 等配置，不动数据目录。
- 服务与一致性：为保证一致性，恢复前建议停止服务；如采用拷贝方式，先备份当前数据目录留回滚点。
- 备份文件就绪：准备好时间戳备份包，例如 zookeeper-backup-2025xxxx.tar.gz 与 zookeeper-config-backup-2025xxxx.tar.gz。
二 标准恢复步骤
- 停止服务：
sudo systemctl stop zookeeper
- 恢复数据目录（全量）：
- 解压到根目录：
sudo tar -xzvf /path/to/zookeeper-backup-2025xxxx.tar.gz -C /
- 如包内含顶层目录（如 var/lib/zookeeper），也可先解压到临时目录，再用
rsync -a 或 cp -a 覆盖到实际 dataDir。
- 仅恢复配置：
sudo tar -xzvf /path/to/zookeeper-config-backup-2025xxxx.tar.gz -C /etc/zookeeper/conf
- 启动服务：
sudo systemctl start zookeeper
- 验证：
- 四字命令：
echo ruok | nc localhost 2181，返回 imok 表示服务就绪。
- 客户端检查：
./zkCli.sh -server localhost:2181 ls /，确认关键 znode 是否存在。
三 集群环境注意事项
- 逐节点操作：对 ensemble 的每个节点重复“停止 → 恢复 → 启动”，避免同时重启导致选主抖动。
- 配置一致性：确保各节点的 zoo.cfg（如 server.x=… 列表）与恢复前一致，避免 myid 或 quorum 配置不匹配。
- 数据一致性：如条件允许，优先在单节点完成恢复与验证，再滚动重启其他节点。
- 版本与兼容性：恢复前后的 Zookeeper 版本 尽量保持一致，避免元数据格式差异。
四 常见问题与排查
- 权限问题：解压或拷贝后确保 zookeeper 用户对数据目录有读写权限，必要时执行：
sudo chown -R zookeeper:zookeeper /var/lib/zookeeper
- 端口占用：
sudo lsof -i:2181 检查端口占用，释放后再启动。
- 数据不完整：若恢复后 znode 缺失，检查是否解压到了错误的 dataDir，或备份包是否完整。
- 配置覆盖风险：仅恢复配置时，避免误覆盖 dataDir；必要时先备份当前目录。
五 不停止服务的替代方案
- 在线导出导入：使用 zkCli.sh 的
export/read 或 snapshot 功能导出 znode 树，再在目标集群 create/set 导入；适合小体量或可接受短暂只读窗口的场景。
- 应用侧双写：在业务低峰期将写操作同时指向新旧集群，完成数据迁移后再切换。
- 风险提示：在线方式对一致性要求高，务必在测试环境演练并评估对线上业务的影响。