Consul客户端连不上本地agent主因是地址、协议或ACL权限配置错误：需用curl验证http://127.0.0.1:8500/v1/status/leader可达，Address必须带http://协议，启用ACL时须显式传Token，Docker中宿主机访问应改用host.docker.internal（Mac/Win）或宿主机真实IP（Linux）。
consul.NewClient 连不上本地 agent 怎么办
连不上不是代码写错了，是地址、协议或权限没对齐。默认 consul.NewClient 会试 http://127.0.0.1:8500，但 Consul agent 可能根本没开这个接口，或者监听在 localhost 而不是 127.0.0.1（Go 的 DNS 解析会让两者行为不一致）。
- 先手动验证 agent 是否可访问：
curl -v http://127.0.0.1:8500/v1/status/leader，别只信consul members输出 - 初始化 client 时显式指定带协议的完整地址：
cfg.Address = "http://127.0.0.1:8500"，缺http://会 panic - 如果 Consul 启用了 ACL，必须传
Token字段，空字符串或不设等于触发默认拒绝策略，且不报错 - Docker 场景下，宿主机 Go 程序访问容器内 Consul 不能用
127.0.0.1，Mac/Windows 改用http://host.docker.internal:8500，Linux 改用宿主机真实 IP
服务注册后 HealthCheck 一直 critical
注册成功 ≠ 服务健康，Consul 默认按你配的 Check 轮询，失败就标为不可用。最常卡在这儿：HTTP 检查 URL 不通、路径不对、超时不匹配，或压根没启动目标服务。
-
HTTP字段必须是完整 URL（如"http://192.168.1.100:8080/health"），不能只写路径"/health" - 地址必须是 Consul agent 能直接访问的——
localhost在跨容器/跨机器场景下无效，得填宿主机 IP 或可解析域名 -
Timeout必须大于服务实际响应时间；比如接口耗时 800ms，Timeout: 500 * time.Millisecond必挂 - 若用
TTL类型检查，必须配套调client.Agent().PassTTL()续命，否则 30 秒后自动变critical - 开发阶段建议优先用
TCP检查（GRPC或HTTP端口连通性），避开路由、HTTPS 重定向等干扰
服务发现查不到刚注册的实例
client.Agent().Services() 返回的是本机注册的服务列表，跟“发现”完全无关。真正做负载均衡式发现，必须走健康检查视角的 API。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 用
client.Health().Service()查询，不是client.Agent().Services() - 关键参数
passingOnly必须设为true，否则会拿到大量critical状态节点，下游调用直接失败 - 注册时
ID必须全局唯一（建议拼接主机名+端口，如"user-service-192.168.1.100-8080"），重复 ID 会导致覆盖而非新增 -
Name字段不要含空格或特殊字符，虽然注册不报错，但后续 DNS 查询（如user-service.service.consul）会失败
进程退出时服务还在 Consul 上挂着
没主动注销，Consul 会等 TTL 过期或健康检查失败才下线，期间流量照打不误。这不是延迟问题，是逻辑遗漏。
立即学习“go语言免费学习笔记（深入）”；
- 用
signal.Notify捕获SIGINT/SIGTERM，在信号处理函数里调client.Agent().ServiceDeregister() - 别依赖
defer写在main末尾——有 goroutine 运行时，main返回 ≠ 进程退出 - 注销前加日志：
log.Printf("deregistering service %s", serviceID)，确认执行路径是否走到 - 若用了
TTL检查，注销前建议先调client.Agent().FailTTL()，让 Consul 立即标记为不可用，再 deregister
Consul 是独立运行的服务，Golang 微服务只是客户端；所有连接都应指向本地或同机房的 Consul agent（8500 端口），永远不要在 Go 代码里写跨数据中心的 Consul 地址——那是 agent 自己该干的事。
