使用 Consul SDK 时容易踩哪些坑？

直接回答

先确认库支持服务端版本和实际使用的端点，并检查超时、授权、重试和一致性配置。库能连通 agent，之后还要确认读、写和阻塞查询是按预期工作的。

讲清原理

对查询能做有限重试。注册或条件写超时会出现结果未知，应按实例 ID 或键的当前版本确认再行动。维护阻塞查询时处理索引回退。用了 ACL 也要识别“结果被过滤”和“确实没有服务”的区别。

例子与易错点

查询返回空列表时，先核对权限、服务名、健康筛选和数据中心。调用一个旧缓存地址时仍要有独立的连接和请求超时。

延伸阅读 用 Consul HTTP API 如何查到可用实例？ · 如何用阻塞查询等待 Consul KV 变化？ · 怎么把 Consul 接入 Spring Cloud 应用？