gin.default() 不适用于生产环境，因其默认启用的logger（阻塞式输出）和recovery（泄露敏感信息）存在性能与安全风险，应改用gin.new()手动注册zaplogger、recoverywithalert等安全中间件。
gin.Default() 不能直接用于生产环境
它默认启用 Logger 和 Recovery 中间件，这两者在高并发或安全要求高的场景下会出问题。
-
Logger默认写到os.Stdout，无缓冲、串行、阻塞式输出，QPS 超过 2k 就明显拖慢响应 -
Recoverypanic 时直接打印完整堆栈，可能泄露源码路径、变量值、数据库连接字符串等敏感信息 - 调试模式（
GIN_MODE=debug）还会开启 HTML 错误页面，暴露内部结构
正确做法是用 gin.New() 手动注册中间件：
func main() {
r := gin.New()
r.Use(zapLogger()) // 换成结构化日志（如 zap）
r.Use(recoveryWithAlert()) // 自定义 panic 处理，只上报不暴露
r.Use(authMiddleware()) // 统一鉴权
r.GET("/api/user/:id", getUserHandler)
r.Run(":8080")
}
在 Goroutine 中必须用 c.Copy()
原始 *gin.Context 不是线程安全的，且生命周期仅限于当前 HTTP 请求处理周期。一旦 handler 函数返回，上下文对象就可能被复用或重置。
- 直接在 goroutine 中读写
c.Param()、c.Get()或c.Set()，大概率读到空值、旧值，甚至 panic -
c.Copy()返回一个只读副本，保留请求参数、路径、Header 等只读字段，但隔离了c.Keys和其他可变状态 - 即使只是读
c.Query("q")，也不建议在 goroutine 中直接调用——因为c.Query()内部会触发r.URL.Query()解析，而原*http.Request可能已被回收
错误写法：
gofunc() {
value, _ := c.Get("user_id") // ❌ 可能为 nil 或已覆盖
// ...
}()
正确写法：
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
cc := c.Copy()
gofunc() {
value, ok := cc.Get("user_id") // ✅ 安全读取
if ok {
// ...
}
}()
路由注册顺序影响匹配结果
Gin 使用最长前缀匹配 + 注册顺序优先策略。动态参数路由（如 /user/:id）如果注册在静态路由（如 /user/create）之后，会导致后者永远无法命中。
- 注册顺序决定优先级：先注册的路由先尝试匹配
-
/user/:id是通配，会吃掉所有/user/xxx，包括/user/create - 子路由组（
router.Group("/api")）不影响全局顺序，只影响组内相对顺序
推荐做法：静态路由放前面，动态路由放后面；避免把 /admin/*any 这类兜底路由放在最前。
r.GET("/user/create", createHandler) // ✅ 先注册
r.GET("/user/:id", detailHandler) // ✅ 后注册
// 不要反过来，否则 /user/create 总被 :id 捕获
中间件里忘了调用 c.Next()
这是最隐蔽也最常踩的坑之一。Gin 中间件靠 c.Next() 控制执行流是否继续向下传递。漏掉它，后续中间件和 handler 就不会执行，客户端会一直等待超时。
-
c.Next()不是“可选”，而是“执行链路开关” - 如果中间件要做鉴权，校验失败时应
c.Abort()并返回，而不是直接return—— 否则c.Next()不会被跳过，后续逻辑仍可能执行 - 日志中间件中，
c.Next()前后的时间差才是真实耗时，别在c.Next()前就记录结束时间
典型错误：
func authMiddleware() gin.HandlerFunc {
return func(c *gin.Context) {
if !isValidToken(c) {
c.JSON(401, gin.H{"error": "unauthorized"})
return // ❌ 忘了 Abort，且没调 Next，但更糟的是没中断链路
}
// 下面这行不写，/user/:id 就永远不会被执行
c.Next() // ✅ 必须有
}
}
真正容易被忽略的是 Context 生命周期和 Goroutine 的耦合关系——不是所有“看起来能用”的变量，在异步场景下都真能用。哪怕只多启一个 goroutine，c.Copy() 就不是可选项，而是必选项。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
