context deadline exceeded 错误大概率是客户端连接配置问题而非网络或 etcd 故障，常见于 endpoints 未配协议、tls 配置缺失或不匹配。
etcd 客户端连接失败：context deadline exceeded 是网络还是配置问题？
context.DeadlineExceeded 错误大概率不是 etcd 本身挂了，而是客户端连不上——常见于没配对 endpoints 或 TLS 配置错。go 客户端默认只连第一个 endpoint，如果它不可达且没设重试，就直接超时。
- 确保
endpoints是完整地址，带协议和端口，比如[]String{"<a href="https://www.php.cn/link/03187c1828b4a98ed9f66691406245a5">https://www.php.cn/link/03187c1828b4a98ed9f66691406245a5</a>"}，不是"127.0.0.1:2379"（缺协议会静默降级为 http） - 如果启用了 TLS，必须同时提供
tls.Config，哪怕只是跳过校验（仅测试）：cfg := &config.Config{Endpoints: endpoints, TLS: &tls.Config{InsecureSkipVerify: true}} - 生产环境别用
InsecureSkipVerify，要加载 CA 证书：tls.LoadX509KeyPair("cert.pem", "key.pem")，并把 CA 传给RootCAs
Put 和 Get 配置值时，为什么 key 能写进去但读不到？
etcd 的 key 是严格区分大小写和前缀的，而且不自动补 /。常见掉坑点：
- 写入用了
/config/app/db/host，读的时候用了config/app/db/host（少开头的/），这两个是完全不同的 key - 用
clientv3.WithPrefix()查询时，传的 prefix 必须是目录式结尾，比如查所有/config/app/下的项，得传"/config/app/"，不是"/config/app" - 如果 key 是
/config/app，而你用WithPrefix("/config/")去查，它会命中；但用WithPrefix("/config")（无尾部/）则不会——因为 etcd 按字节序匹配，/config字典序小于/config/
Watch 配置变更时，为什么第一次响应就断了？
clientv3.Watch 默认是一次性监听，除非显式启用流式监听。很多人写了 watch 却发现只触发一次，就以为接口坏了。
- 正确做法是用
client.Watch(ctx, key, clientv3.WithRev(0))，其中WithRev(0)表示从最新 revision 开始监听；不加这个参数，watch 会从当前 revision + 1 开始，如果期间没变更，就立刻结束 - 更稳妥的是先
Get一次拿到当前kv.Header.Revision，再用WithRev(rev)启动 watch，避免漏掉中间更新 - 注意 ctx 生命周期：watch 是长连接，如果传入的
ctx被 cancel 或超时，watch 会立即退出，别用短命的context.WithTimeout包着整个 watch 循环
在 kubernetes 中用 etcd 存配置，和本地直连有什么关键区别？
K8s 集群内的 etcd 默认不暴露给 Pod，应用通常不该、也不能直连它。所谓“用 etcd 存配置”，真实路径一般是：
立即学习“go语言免费学习笔记（深入）”；
- 应用通过 K8s API Server 间接操作 etcd（比如用 ConfigMap / Secret），API Server 负责鉴权和审计，这才是推荐方式
- 如果真要直连（如自建 etcd sidecar），必须确保 Pod 网络能通 etcd 成员端口（
2379），且 service DNS 解析正确（比如etcd-cluster.default.svc.cluster.local:2379） - etcd v3.5+ 默认开启 gRPC 连接复用，但 K8s 环境下 LB（如 kube-proxy）可能干扰 keepalive，建议在 client 配置里显式设置：
grpc.WithKeepaliveParams(keepalive.ClientParameters{Time: 10 * time.Second})
etcd 的原子性和 Watch 语义很干净，但 Go 客户端对错误恢复、连接重试、revision 对齐这些事不自动兜底——每个环节都得自己判、自己续、自己对齐。写两行 Put 很快，让配置热更新稳跑三个月，才是难点。