搭建Golang环境与服务发现组件的对接配置-Golang-PHP中文网

go服务注册consul必须带健康检查，否则视为无效注册；http检查比tcp更可靠，地址须consul可访问，id需全局唯一，应避免ttl模式，服务发现需缓存并过滤passing状态实例。

搭建golang环境与服务发现组件的对接配置

不加 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 都可能触发误注销

Go 默认的 net/http 客户端会缓存 DNS 结果，order-service.service.consul 这类 DNS 名返回的 A 记录不会自动刷新，查到的可能是已下线节点。

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

改用 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 读配置，但 key 路径不是文件系统语义，而是 Consul 的 KV 层级结构，/config/app/redis/addr 在 Viper 里得写成 "config.app.redis.addr"（点分隔）。

初始化时调 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 或改优先级

本地调试时，Go 服务连不上 Consul 最常见的原因是网络隔离——Docker 默认 bridge 网络下，容器间不能用 localhost 互访。

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"