ZooKeeper连接不稳定需综合优化：设30–60秒超时、指数退避重连、监听EventChan处理SessionExpired/Disconnected、操作前校验StateHasSession；分布式锁须显式创建父路径、主动删除节点、避免耗时IO；ChildrenW需手动重注册；ACL权限在连接时通过auth参数设定，非请求级生效。
zookeeper 连接不稳定，zk.Connect 频繁超时怎么办
Go 官方不提供 ZooKeeper 客户端，主流选择是 github.com/samuel/go-zookeeper/zk，但它默认连接超时极短（约 10 秒），且不自动重连。生产环境里一断网或 zk 集群抖动，zk.Connect 就直接返回 zk.ErrConnectionClosed 或上下文超时，后续所有操作全挂。
必须显式控制连接生命周期：
- 用
context.WithTimeout包裹zk.Connect，但超时时间建议设为 30–60 秒，而非默认值 - 连接失败后不要立即 panic，应循环重试（带指数退避），直到成功或整体上下文取消
- 连接成功后，务必启动一个 goroutine 监听
*zk.Conn.EventChan()，捕获zk.EventSessionExpired和zk.EventDisconnected，触发重建连接 - 所有读写操作前，先调用
conn.State() == zk.StateHasSession校验会话有效性，否则可能静默失败
用 zk.Create 实现分布式锁时，临时顺序节点没被自动清理
ZooKeeper 分布式锁依赖 EphemeralSequential 节点，但 Go 客户端不会替你管理会话生命周期——一旦进程崩溃、网络中断或 GC 导致连接对象被回收，zk 服务端无法及时感知，节点就变成“幽灵节点”，锁永远卡死。
关键动作不是靠 defer conn.Close()，而是：
- 创建锁节点时，必须传入完整路径（如
/locks/my-service/lock-），且确保父路径/locks/my-service已存在（用zk.Create带zk.FlagPersistent显式创建） - 不要依赖
conn.Close()触发节点删除；应在业务逻辑出口处主动调用zk.Delete删除自己创建的节点，哪怕 panic 也要用defer包一层 - 加锁逻辑需包含“检查前序节点是否存在并已释放”的步骤，否则单靠节点顺序不能保证 FIFO
- 避免在锁持有期间做耗时 IO（如 HTTP 请求、DB 查询），否则会拖垮整个锁队列
zk.ChildrenW 监听子节点变化，回调没触发或重复触发
zk.ChildrenW 是一次性 watcher：只通知一次变更，之后必须重新注册。很多人误以为它像文件系统 inotify 那样持续监听，结果子节点增删后完全收不到事件。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
正确做法是把 watcher 注册和事件处理做成闭环：
- 调用
zk.ChildrenW("/path", &stat)后，立刻从返回的watcherCh := conn.EventChan()中 select 等待事件 - 收到
zk.EventNodeChildrenChanged后，**必须再次调用zk.ChildrenW** 重新设置 watcher，否则下次变化无响应 - 注意并发安全：多个 goroutine 同时对同一路径调用
ChildrenW可能导致 watcher 覆盖，建议用单个 goroutine 串行管理监听路径 - 如果监听路径下子节点频繁变动（如服务发现场景），建议加一层本地缓存 + diff，避免每次变更都触发全量 reload
用 zk.SetACL 控制权限，但 zk.ErrNoAuth 报错难定位
ZooKeeper ACL 是连接级生效的，不是请求级。你在连接时没传 zk.DigestACL，后续所有 SetACL、Create 带 ACL 的操作都会返回 zk.ErrNoAuth，错误信息里却不会提示缺认证。
ACL 生效的前提非常具体：
- 连接时必须传入
zk.ACL列表，例如zk.WorldACL(zk.PermAll)或自定义zk.DigestACL - 若使用 digest 认证，需提前在 zk server 的
zoo.cfg中配置authProvider.1=org.apache.zookeeper.server.auth.SASLAuthenticationProvider，并生成对应digest值（用java -cp zookeeper.jar org.apache.zookeeper.server.auth.DigestAuthenticationProvider user:pass） -
zk.SetACL只能由创建节点的用户或 super 用户执行，普通连接即使有写权限也无法改 ACL - 调试时可先用
zk.GetACL查看目标节点当前 ACL，比盲猜更可靠
zk 的会话模型和权限体系和常见数据库差异很大，最常被忽略的是：连接建立时的 auth 参数决定了一切后续操作的权限边界，而不是每次请求都传凭证。
