必须在gin.default()或gin.new()前调用gin.setmode(gin.releasemode)，否则调试开销不关闭，导致qps下降；releasemode需提前设置，因default()启动时即读取mode初始化中间件，后设无效。
必须在 gin.Default() 或 gin.New() 之前调用 gin.SetMode(gin.ReleaseMode)，否则调试开销不会被关闭——这是线上 QPS 下降最隐蔽的根源之一。
ReleaseMode 必须在 gin 实例创建前设置
很多人把 gin.SetMode(gin.ReleaseMode) 放在 r := gin.Default() 之后，这完全无效。因为 gin.Default() 内部会立即读取当前 mode 并初始化 logger、recovery 等中间件，此时再改 mode 已无意义。
- 正确顺序：先
gin.SetMode(gin.ReleaseMode)，再r := gin.Default() - 更稳妥写法是不用
Default()，改用gin.New()+ 手动注册必要中间件（如gin.Logger()、gin.Recovery()），避免隐式依赖 - 启动时加一行日志确认：
log.Printf("Gin mode: %s", gin.Mode())，防止环境变量或构建脚本覆盖
配置加载失败时不能只检查 viper.ReadInConfig() 是否 nil
viper.ReadInConfig() 成功只代表文件存在且语法合法，不保证字段可用。生产环境常见问题是 server.port 空、database.url 缺失，但服务照常启动，直到第一个请求才 panic。
- 启动时显式校验必填字段：
viper.GetString("server.addr") == ""、viper.GetInt("server.port") == 0 - 把关键路径列成切片统一检查：
[]string{"database.host", "database.port", "redis.addr", "jwt.secret"} - 若用环境变量注入（如
APP_DATABASE_HOST），需提前调viper.AutomaticEnv()和viper.SetEnvKeyReplacer(strings.NewReplacer(".", "_"))
sync.Pool 对象复用必须重置，否则响应体混杂脏数据
启用 ReleaseMode 后，sync.Pool 复用变频繁，但很多人忘了重置对象字段。比如用 *bytes.Buffer 做响应体缓冲，没调 buf.Reset()，结果用户 A 的 JSON 里冒出用户 B 的字段。
- 每次
pool.Get()后立刻重置：buf.Reset()、req.Header = nil、msg.ID = 0 -
Pool.New函数必须返回已清零对象：&MyStruct{}而不是new(MyStruct)（后者不保证字段为零值） -
pool.Put()前确保无 goroutine 还在引用该对象，尤其避免defer pool.Put(x)后继续用x.Data这类指针字段
最容易被忽略的是：ReleaseMode 关闭了模板热重载和 debug 页面，但如果你代码里还手动调用了 c.HTML() 渲染未编译模板，或依赖 gin.DebugPrintRouteFunc，这些地方会在上线后静默失败——得靠集成测试覆盖 HTML 路由路径，而不是只测 JSON 接口。
