Consul KV 不支持自动推送，需用阻塞查询（带 WaitIndex）监听变更；viper 不自动热更新，须手动重载并原子替换配置；环境隔离靠 Consul 路径前缀而非 viper.SetEnvPrefix。

Consul 不能自动刷新 Go 服务里的变量，viper 不监听 Consul 变更，必须手动实现长轮询 + 原子替换，否则改了 KV 服务完全无感。

client.KV().Get() 是单次请求，不是监听

直接调用 client.KV().Get("dev/service/auth/timeout") 只会拿一次值，返回后连接就断开，后续 Consul 里改了这个 key，你的服务根本收不到。这不是 bug，是设计如此——Consul 的 KV 接口本身不带“推送”能力。

• 真正可靠的做法是用阻塞查询（blocking query）：首次请求后记录 pair.ModifyIndex，下次带上 &api.QueryOptions{WaitIndex: lastIndex, WaitTime: 60 * time.Second}
• Consul 会在该 index 后有变更时立刻返回；没变更则挂起最多 60 秒，超时后也返回（空或旧值），此时应立即发起下一轮请求
• 别用 client.KV().List() 轮询路径——高频空查会压垮 Consul，且无法精准感知单 key 变更

viper.ReadConfig() 不等于配置已生效

viper.ReadConfig() 只是把字节流反序列化进 viper 内部 map，它不会触发任何业务逻辑更新。数据库连接池、HTTP client 超时、JWT 密钥这些全得你手动重设。

Colly Golang Web Scraper and Crawler Framework

Colly 是一个用于 Go 语言的快速开源爬取和爬虫框架。它适用于从简单的页面提取到异步爬虫处理大量页面集合，支持请求回调和结构化解析。

下载

• 结构体字段必须首字母大写（导出），并显式加 mapstructure:"redis_url" tag（不用 json:），否则 YAML/TOML 解析可能失败
• 更新前必须用 sync.RWMutex 或 atomic.Value 包裹配置指针；读取时调 atomic.LoadPointer() 或 mu.RLock()，不能裸写全局 struct
• 示例：DB 连接池参数变了，得显式调 db.SetMaxOpenConns(newCfg.DB.MaxOpen)；密钥变了，得重建 jwt.SigningMethodHS256 实例

环境隔离靠路径前缀，不是 viper.SetEnvPrefix

viper.SetEnvPrefix() 只影响 OS 环境变量映射，对 Consul 完全无效。90% 的“dev 配置改了影响 prod”问题，根源是 KV 路径没分环境。

立即学习“go语言免费学习笔记（深入）”；

• 路径必须带环境前缀，比如 fmt.Sprintf("%s/service/auth/", os.Getenv("ENV"))，生成 dev/service/auth/ 或 prod/service/auth/
• ACL policy 必须按路径限制权限，例如给 dev 服务只开 dev/* 的 read 权限，避免越权读取
• 不要把所有配置塞进单个 key（如 service/auth/timeout），而是用前缀监听整个目录，否则新增子项（如 service/auth/retry）会漏触发

最易被忽略的点是首次加载失败必须阻塞或 panic：Consul 不可用、路径不存在、JSON 格式错误，这些都应在启动阶段暴露。带着空配置跑起来，后面全是 nil pointer dereference，比启动失败更难排查。