Consul KV 的 HTTP API 有哪些设计特点？

直接回答

单键读写用 /v1/kv/<key>。普通读返回含索引等元数据的 JSON，字节值在 Value 中用 Base64 表示。使用 raw 可直接取得内容，按前缀列出可用 recurse 或 keys。

讲清原理

ModifyIndex 可做条件写。比较失败时 PUT 响应体可以是 false，客户端应同时检查 HTTP 状态和响应内容。需要打包修改多个键时，可以用事务接口，官方 API 给出 512 KB 的上限。

例子与易错点

两个管理员同时写同一个开关时，使用读到的 ModifyIndex 发 CAS。收到 false 的一方先重新读，不把别人的改动覆盖掉。

延伸阅读 Consul KV 是什么，适合怎么用？ · Consul KV 怎么增删查改？ · Consul Blocking Query 和 Watch 有什么关系？