etcd通过Raft强一致性协议和Watch长连接机制实现配置实时同步，服务监听指定key或prefix，变更时立即推送事件，避免轮询延迟与集群配置不一致。
配置同步不是“把 config.yaml 复制到所有机器”那么简单，它本质是服务启动后还能动态感知并应用配置变更——而分布式协调器（如 etcd、Consul）就是干这个的。
为什么硬编码或本地文件配置在微服务里会出问题
当你的 user-service 和 order-service 都读同一个 config.yaml，改个数据库密码就得重新编译、发版、重启——这违背了微服务“独立部署”的前提。更糟的是：某次发布只更新了部分实例，导致集群内配置不一致，sql.ErrNoRows 突然变多，查日志发现一半服务连的是旧库地址。
- 本地文件无法跨进程通知变更，除非轮询（浪费 CPU + 延迟高）
- 环境变量只在进程启动时生效，运行中改了无效
- 硬编码等于把配置逻辑写死进业务代码，违反关注点分离
etcd 是怎么做到实时同步配置的
etcd 不是“配置仓库”，而是带监听能力的分布式键值存储。你往 /config/user-service/db/host 写值，所有监听该 key 的服务会立刻收到事件，而不是等下一次 HTTP 请求才检查。
- Go 客户端用
clientv3.Watch订阅路径前缀，底层走 gRPC stream，事件延迟通常 - 监听不是轮询：etcd 服务端主动推送变更，客户端无需定时拉取
- watch 可设
WithPrefix(true)，一次监听整个配置树（比如/config/order-service/下所有子 key） - 注意重连逻辑：网络断开时 watch channel 会关闭，必须重建 watch 并从上次 revision 续订，否则丢变更
Consul 的 KV + Watch 和 etcd 有啥关键区别
Consul 的 KV 模块也能做配置同步，但它的 watch 机制是长轮询（HTTP 保持连接），不如 etcd 的 gRPC stream 稳定，尤其在 Kubernetes Pod 频繁重建场景下容易超时断连。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- Consul 的优势在于和 service mesh（如 Envoy）深度集成，适合同时管理服务注册+配置
- etcd 更轻量、性能更高，Kubernetes 自身就用它存集群状态，生态工具链更成熟（比如
etcdctl直接调试） - 两者都支持租约（lease）：配置项可绑定 TTL，服务下线后自动清理对应配置，避免脏数据
- 别直接用 Consul 的 HTTP API 做高频 watch——Go 客户端要显式处理
429 Too Many Requests，etcd 的 gRPC client 内置限流更友好
配置变更后，服务内部怎么安全地热更新
拿到新配置不能直接覆盖全局变量，尤其涉及数据库连接池、gRPC 客户端这类有状态对象。常见踩坑点是：新 DB 地址生效了，但旧连接池还在用老地址，直到连接超时才报错。
- 用
sync.RWMutex保护配置结构体，读多写少场景下性能损失小 - 连接池类对象（如
*sql.DB）必须重建：关掉旧 pool 的Close()，再用新配置初始化新 pool - gRPC 客户端建议按需新建，不要复用旧 client——不同 endpoint 的 TLS 配置可能不同
- 避免在 watch 回调里直接改业务逻辑状态，先发到 channel，由专用 goroutine 串行处理，防止并发冲突
真正难的不是“怎么监听”，而是“监听到之后怎么不崩”。配置热更新失败往往不会立刻 panic，而是让服务慢慢降级：连接数涨、超时增多、日志里出现大量 context deadline exceeded ——这些信号比配置本身更值得监控。
