Gin 本身不处理服务注册，必须由业务层显式调用 Consul API 完成；若注册时未配置 Check 字段，服务状态恒为 critical，Health().Service() 默认查不到该实例。
Gin 本身不处理服务注册，必须由业务层显式调用 Consul API 完成注册；直接在 Gin 启动后调用 consul.Agent().ServiceRegister() 是最简可行路径，但漏掉健康检查配置会导致服务始终处于 critical 状态。
Consul 服务注册必须带 Check 字段，否则状态永远是 critical
Consul 不会为注册服务自动添加健康检查。即使 ServiceRegister 调用成功，若未传入 Check 字段，该实例在 UI 和 API 查询中都会显示为 critical，客户端通过 Health().Service() 查不到它（默认只返回 Passing 实例）。
- HTTP 健康检查最常用：设置
Check.HTTP = "http://127.0.0.1:8080/health"，并确保 Gin 路由已注册该 endpoint -
Check.Timeout必须显式设（如"5s"），否则 Consul 使用默认 1s，容易误判超时 -
Check.Interval建议设为"10s"，太短增加 Consul 压力，太长故障发现延迟高 - 不要依赖
TTL模式——它需要服务主动上报心跳，出错概率远高于 HTTP 检查
注册前需确认 Consul agent 可连通，且服务地址对其他服务可达
注册时填的 Address 和 Port 是其他服务调用你的 gRPC 或 HTTP 接口时实际使用的地址。本地开发常填 "127.0.0.1"，但这会导致其他容器或主机上的服务无法访问。
- 单机调试可用
"localhost"或"127.0.0.1"，但必须同步启动 Consul agent 并监听client_addr = "0.0.0.0" - Docker 环境下，
Address应填容器名（如"user-srv"）或宿主机 IP（如"172.17.0.1"），不能填"127.0.0.1" - 注册前建议先用
net.Dial("tcp", address+":"+port)主动探测端口是否 ready，避免注册了不可达地址 - Consul client 初始化时，
Address配置项必须是其他服务能解析到的地址（如"http://consul:8500"），不是"127.0.0.1:8500"（容器内不可达）
服务注销要主动调用 Deregister，别依赖 TTL 过期
进程退出时不显式注销，Consul 里会残留一个 critical 实例，下次同名服务启动可能因 ID 冲突注册失败，或导致负载均衡把流量打到已下线节点。
- 用
os.Interrupt和os.Kill注册信号处理器，在os.Exit(0)前调用consul.Agent().ServiceDeregister(serviceID) -
serviceID必须和注册时一致；建议生成规则为"user-srv-" + uuid.NewString()，避免多实例 ID 冲突 - 不要依赖 Consul 的
TTL自动清理——网络抖动可能导致租约意外过期，引发服务闪断 - 如果用了优雅停机（如
http.Server.Shutdown()），注销逻辑应放在 Shutdown 完成之后，确保不再接收新请求再下线
最容易被忽略的是健康检查路径的可达性：Gin 的 /health 路由必须返回 HTTP 200，且响应体为空或仅含简单 JSON；任何中间件（如 JWT 鉴权、CORS）拦截该路径都会让 Consul 认为服务异常。注册逻辑和健康检查 endpoint 必须解耦，不能共用同一套鉴权链路。
