Gin需借助viper桥接Consul KV加载JSON配置：先HTTP拉取raw JSON，再v.ReadConfig()解析并Unmarshal到结构体，且字段tag须与JSON键名严格一致；配置必须在gin.Engine创建前完成加载，否则端口等参数将失效。
Gin 本身不内置配置中心能力，必须靠第三方库（如 viper）桥接 Consul KV 存储。Consul 的 JSON 配置项不能直接被 Gin 读取，关键在于「如何从 Consul 拉取 JSON 字符串 → 解析为 Go 结构体 → 注入到 Gin 运行时上下文」。
Consul 中 JSON 配置的存储格式要严格匹配 viper.Unmarshal
Consul KV 的 value 必须是合法 JSON 字符串，且字段名需与目标结构体 tag 一致。常见错误是把 YAML 当 JSON 用，或忽略大小写/下划线规则。
- ✅ 正确示例（Consul KV key:
config/app，value）：{"app":{"env":"prod","port":8080,"app_name":"user-api"}} - ❌ 错误示例：value 是
app: { env: prod }（YAML 格式，viper 无法解析） - ❌ 错误示例：结构体字段用
Env string `json:"ENV"`，但 JSON 里是"env"，导致字段为空 - Consul 不校验 JSON 合法性，
viper.Unmarshal()失败时只会静默跳过或 panic，务必加if err != nil判断
用 viper 连 Consul 并加载 JSON 需手动触发 Get() + Unmarshal
viper 默认只支持文件、环境变量等后端，Consul 需通过 HTTP client 主动拉取，再喂给 viper.ReadConfig()。不能依赖 viper.AddRemoteProvider()（它只支持 etcd / consul 的旧版 API，且不支持 JSON 解析）。
- 先用
http.Get("http://127.0.0.1:8500/v1/kv/config/app?raw")获取 raw JSON 字符串 - 用
viper.New()创建新实例，调用v.ReadConfig(strings.NewReader(rawJSON)) - 再执行
v.Unmarshal(&cfg)，其中cfg是你定义的结构体变量 - 别在
init()里做这事——Consul 可能未就绪；应放在main()开头或initialize/config.go中显式调用
Gin 路由初始化前必须完成配置加载
如果配置里含 app.port 或数据库连接字符串，而你在 gin.Default() 之后才加载，会导致服务启动在默认 8080 端口，而非配置指定端口。
- 典型顺序：加载 Consul 配置 → 构建
Configuration结构体 → 初始化全局变量（如global.Config = cfg）→ 调用gin.SetMode()→ 创建gin.Engine→ 注册路由 →r.Run(fmt.Sprintf(":%d", cfg.App.Port)) - 别把配置加载逻辑塞进中间件——中间件在请求进来后才执行，启动参数（如端口、日志级别）早就固定了
- Consul 返回 404（key 不存在）或 503（连接失败）时，
http.Get()会返回 error，必须处理，否则程序 panic 或使用空配置
Consul 的 JSON 配置加载本质是「一次性的 HTTP 请求 + 反序列化」，没有自动监听变更。如果需要热更新，得自己起 goroutine 定期轮询 /v1/kv/... 并对比 ETag，再触发 viper.Unmarshal() 和业务逻辑重载——这不是 Gin 或 viper 的职责，而是你代码里要补的胶水逻辑。
