Consul 服务端开发模式最简启动命令为 consul agent -dev -ui -client=0.0.0.0，监听8500端口，支持远程访问Web UI；该模式数据仅存内存，不可用于生产或压测。
Consul 服务端怎么起，本地开发够用就行
开发阶段不需要集群，consul agent -dev -ui -client=0.0.0.0 一条命令跑起来最省事。它会监听 8500 端口，打开 http://localhost:8500 就能看到 Web UI。注意这个模式数据全在内存里，关掉就丢，别拿去压测或上生产。
常见错误现象：浏览器打不开、报 connection refused —— 大概率是没加 -client=0.0.0.0，默认只绑 127.0.0.1，Docker 或远程调用时连不上。
Gin 项目里怎么读 Consul 的 KV 配置
Consul 的配置本质是 KV 存储，不是“配置中心服务”，Gin 本身不直接对接 Consul，得靠 viper 桥接。关键点有三个：
- 必须提前
go get github.com/spf13/viper/remote，否则viper根本不认识consul协议 - 初始化时要显式注册驱动：
viper.AddRemoteProvider("consul", "127.0.0.1:8500", "/")（路径末尾的/很重要，不然读不到子 key） -
viper.SetConfigType("yaml")必须设对，Consul 里存的值要是合法 YAML 字符串，比如{"port": 8080, "timeout": "5s"}，不能是 JSON 或纯数字
示例片段：
viper.AddRemoteProvider("consul", "127.0.0.1:8500", "/")
viper.SetConfigType("yaml")
err := viper.ReadRemoteConfig()
if err != nil {
log.Fatal(err)
}
// 此时 viper.Get("port") 才能拿到值
配置热更新为什么没反应？WatchRemoteConfig 调用顺序错了
viper.WatchConfig() 对 Consul 完全无效，它只 watch 本地文件。远程热加载必须用 viper.WatchRemoteConfig()，而且有严格前提：
- 必须在
viper.ReadRemoteConfig()成功之后调用，否则 panic：remote config not loaded - 每次变更后，
viper不会自动Unmarshal到结构体，得自己在回调里手动做：viper.OnRemoteConfigChange(func(e fsnotify.Event) { viper.Unmarshal(&cfg) }) - Consul 的 watch 依赖 long polling，默认超时 5 分钟，改完配置后最多等 5 分钟才触发回调，别一刷新就怀疑代码坏了
容易被忽略的地方：Consul 的 KV 路径区分大小写，/gin/config/dev 和 /gin/config/Dev 是两个 key；另外，如果用的是 Consul ACL，没配 token 会导致 ReadRemoteConfig 静默失败，日志里只报 “no config found”，实际是权限拒绝。
