Homebrew安装ZooKeeper需匹配JDK版本：JDK 8应选用3.4.x（如3.4.14），避免默认最新版导致KeeperErrorCode异常；配置文件位于/opt/homebrew/etc/zookeeper/zoo.cfg（Apple Silicon）或/usr/local/etc/zookeeper/zoo.cfg（Intel）；启动用zkServer start-foreground或brew services start zookeeper；验证用zkServer status和zkCli ls /；集群模拟需复制配置、改端口、设独立myid。

直接用 homebrew 安装 zookeeper 在 macos 上很便捷，但默认安装可能因 jdk 版本或 zookeeper 版本不兼容导致连接失败、客户端报错（如 keepererrorcode = unimplemented 或 connectionloss）。关键不是“能不能装”，而是“装对版本 + 配置到位”。

确认环境与安装方式

先确保已安装 Homebrew（没装可运行 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"）；再检查 Java 版本：java -version。ZooKeeper 3.5+ 要求 JDK 11+，若你用的是 JDK 8（仍广泛用于老项目），请务必选 3.4.x 系列（如 3.4.14）。

• 查看可用版本信息：brew info zookeeper
• 若需 JDK 8 兼容，避免 brew install zookeeper（它会装最新版，比如 3.9.x），改用指定 URL 安装稳定旧版：
  brew install https://ghcr.io/volks/legacy-bottles/zookeeper-3.4.14.arm64_big_sur.bottle.tar.gz（M1/M2/M3/M4 适配）或对应 Intel 的包
• 安装成功后，配置文件默认在 /opt/homebrew/etc/zookeeper/zoo.cfg（Apple Silicon）或 /usr/local/etc/zookeeper/zoo.cfg（Intel）

启动与验证服务

Homebrew 提供两种运行方式：后台常驻服务 or 前台临时运行。前者适合长期开发，后者便于调试、避免端口冲突。

macOS Automator Services

部署和使用军舰的 macOS Automator 自动化服务集合。包含 5 个实用工作流：PDF转JPG、PNG重命名并转JPG、图像拼接、解压RAR、顺序命名图像文件。一键安装所有服务到 ~/Library/Services/ 目录。使用场景：(1) "安装我的自动化服务"，(2) "部署所有 Automato...

下载

• 后台启动（开机自启）：brew services start zookeeper
• 前台启动（终端阻塞，方便看日志）：zkServer start-foreground
• 查看状态：zkServer status —— 正常应显示 Mode: standalone
• 连接测试：zkCli 进入客户端后执行 ls /，能返回空列表即表示通信正常

常见问题快速修复

如果 zkServer status 不显示模式，或 zkCli 报连接异常，大概率是配置或端口问题。

• 检查 zoo.cfg 中 clientPort 是否被占用（默认 2181），可用 lsof -i :2181 查看
• 确认 dataDir 目录存在且有写权限（如 /opt/homebrew/var/lib/zookeeper），首次启动前建议手动创建：mkdir -p /opt/homebrew/var/lib/zookeeper && echo "1" > /opt/homebrew/var/lib/zookeeper/myid
• 若用 IDEA 或其他客户端连不上，关闭防火墙或检查是否启用了 Apple 的“全盘访问”权限（macOS 12+ 对某些路径有额外限制）

本地模拟三节点集群（可选）

单机跑多个 ZooKeeper 实例模拟集群，只需复制配置 + 独立端口 + 区分 myid。

• 复制三份配置目录：cp -r /opt/homebrew/etc/zookeeper /opt/homebrew/etc/zookeeper1，同理得 zookeeper2、zookeeper3
• 修改各 zoo.cfg：
  — clientPort=2181 → 分别改为 2181、2182、2183
  — 添加 server 配置（全部三行保持一致）：
  server.1=127.0.0.1:2888:3888
server.2=127.0.0.1:2889:3889
server.3=127.0.0.1:2890:3890
• 为每个实例创建独立数据目录和 myid 文件：
  mkdir -p /opt/homebrew/var/lib/zookeeper1 && echo "1" > /opt/homebrew/var/lib/zookeeper1/myid（对应 2、3 同理）
• 分别启动：zkServer start /opt/homebrew/etc/zookeeper1/zoo.cfg（其余类推）