Gin 不支持运行时热更新全局配置，因 gin.SetMode() 等方法仅影响新 Engine 实例，已启动实例的配置固化不可变；需借助 Viper 监听配置变更并手动同步至 Gin 行为。
Gin 本身不支持运行时热更新全局配置，必须依赖外部机制（如 Viper 监听文件变更 + 自定义重载逻辑）才能实现。
为什么 Gin 的 gin.SetMode() 或 gin.Default() 不能热更新
Gin 的全局配置（如运行模式、日志输出、信任代理列表等）在 gin.Engine 初始化时就固化到实例中，后续调用 gin.SetMode() 只影响新创建的 Engine 实例，对已启动的 r := gin.Default() 无效。常见误操作是改了 gin.SetMode(gin.ReleaseMode) 后 reload 服务却没生效——因为那行代码只在 main 启动时执行一次。
-
gin.SetMode()是包级变量修改，不作用于已有 Engine 实例 -
r.Use()添加的中间件、r.SetTrustedProxies()等方法也只在初始化阶段起效 - 试图在 HTTP handler 里调用这些函数，不会改变当前请求的处理行为
用 Viper 实现配置热加载（推荐方案）
Viper 支持自动监听 YAML/JSON 配置文件变化，并触发回调。但注意：它只负责“读取新配置”，你必须手动将新值同步到 Gin 实例或中间件中。
- 启用监听：
viper.WatchConfig()，并在viper.OnConfigChange()回调里重新解析关键字段 - 需显式更新 Gin 的行为：比如日志级别变了，要替换
gin.LoggerWithConfig中间件；信任代理变了，要重建gin.Engine或接管c.ClientIP()逻辑 - 示例片段：
viper.SetConfigName("config") viper.AddConfigPath(".") viper.ReadInConfig() viper.WatchConfig() viper.OnConfigChange(func(e fsnotify.Event) { // 仅当 config.server.trusted_proxies 变化时才重载 newProxies := viper.GetStringSlice("server.trusted_proxies") // 注意：不能直接改 ginEngine.trustedProxies，它是 unexported 字段 // 正确做法是封装一个自定义 IP 获取函数，内部查 Viper 当前值 })
热更新路由或中间件？别指望 Gin 原生支持
Gin 的路由树在 r.GET() 调用时编译进内存，没有提供运行时增删接口。所谓“热更新路由”，本质是：
- 自己维护一个可变的
map[string]http.HandlerFunc，再用http.ServeMux或自定义http.Handler转发 - 或使用第三方库（如
gorilla/mux+sync.RWMutex包裹路由表） - 强行用
r.Handle()动态注册？不行——Gin 的handle方法不校验重复路径，且不触发 trie 重建，极易导致路由错乱
真正需要热更新配置的场景，往往不是“改个端口号”，而是切换灰度策略、调整限流阈值、刷新证书路径等。这些都得绕过 Gin 的初始化约束，用 Viper + 显式状态管理 + 原子变量（sync/atomic.Value）来承载，而不是寄希望于框架本身能 reload 自己。
