Go服务注册Consul必须带健康检查，否则视为无效注册；HTTP检查比TCP更可靠，地址须Consul可访问，ID需全局唯一，应避免TTL模式，服务发现需缓存并过滤passing状态实例。
Go 服务注册 Consul 必须带健康检查
不加 Check 字段的注册等于无效注册——Consul 会把它当“死节点”剔除，哪怕服务进程还在跑。HTTP 健康检查比 TCP 更可靠，因为只通端口不等于能处理请求。
-
HTTP地址必须可被 Consul 节点访问，常见错误是填localhost导致 Consul 容器里 curl 不通，应填宿主机 IP 或容器网络可解析的域名 -
Interval建议设为"5s"，太短增加 Consul 压力，太长（如"30s"）会导致故障实例滞留时间过长 -
ID必须全局唯一，多实例部署时别用固定字符串，推荐拼接：fmt.Sprintf("%s-%s-%d", serviceName, hostname, port) - 别用 TTL 模式，它依赖服务主动续租，goroutine 泄漏或 GC STW 都可能触发误注销
客户端查 Consul 实例不能靠 DNS 解析
Go 默认的 net/http 客户端会缓存 DNS 结果，order-service.service.consul 这类 DNS 名返回的 A 记录不会自动刷新，查到的可能是已下线节点。
- 改用 Consul HTTP API：调
client.Health().Service("order-service", "", false, &api.QueryOptions{}) - 结果要过滤
ServiceChecks中状态为"passing"的节点，忽略"warning"或"critical" - 别每次请求都查一次 API，开 goroutine 后台每
3–5s轮询并缓存到sync.RWMutex保护的 map 中 - 负载均衡逻辑自己写，轮询最简单；若用随机，记得加锁避免并发读写 panic
Viper + Consul KV 做配置中心要注意路径格式
Viper 支持从 Consul KV 读配置，但 key 路径不是文件系统语义，而是 Consul 的 KV 层级结构，/config/app/redis/addr 在 Viper 里得写成 "config.app.redis.addr"（点分隔）。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 初始化时调
viper.AddRemoteProvider("consul", "127.0.0.1:8500", "config/app/")，末尾斜杠不能少，否则找不到子 key - Consul KV 中存 JSON 值（如
{"host":"127.0.0.1","port":6379}），Viper 才能自动展开为嵌套结构 - 首次读取失败会 panic，需提前用
viper.WatchRemoteConfigOnChannel()并监听 channel 错误 - 本地
config.yaml和 Consul KV 冲突时，Viper 默认以远程为准，如需覆盖逻辑，得手动调viper.SetDefault或改优先级
Docker Compose 里 Consul 与 Go 服务网络互通的关键点
本地调试时，Go 服务连不上 Consul 最常见的原因是网络隔离——Docker 默认 bridge 网络下，容器间不能用 localhost 互访。
立即学习“go语言免费学习笔记（深入）”；
- Consul 容器启动时加
network_mode: "host"或统一用自定义 network：docker network create go-micro，然后所有服务指定networks: [go-micro] - Go 服务里连接 Consul 的地址不能写
"http://localhost:8500"，而应写"http://consul:8500"（前提是 docker-compose.yml 中 Consul service 名为consul） - Consul 的
client_addr配置必须包含容器网络 IP，比如client_addr: "0.0.0.0"，否则只监听 localhost - health check 的
HTTP地址，如果 Go 服务也跑在容器里，要填"http://user-service:8080/health"，而非"http://localhost:8080/health"
