前置过滤器中c.Query()总返回空，因Gin参数解析惰性触发，首次调用才从原始http.Request提取并缓存；过滤器执行时尚未加载，故返回空字符串或默认值。
前置过滤器本身不解析请求参数，它只负责拦截和预处理；真正读取 query/body/form 参数必须在 c.Next() 之后或显式调用解析方法。
为什么 c.Query() 在前置逻辑里总返回空
因为 Gin 的参数解析（如 c.ShouldBind()、c.GetQuery()、c.PostForm()）是惰性触发的——它们首次被调用时才从原始 *http.Request 中提取并缓存。前置过滤器执行时，这些字段尚未加载，直接调用 c.Query("key") 会返回空字符串或默认值。
- 错误写法：
if c.Query("debug") == "1" { log.Println("debug mode") }→ 总是跳过 - 正确做法：要么把参数检查逻辑后移到业务 handler，要么在过滤器中主动触发解析（见下条）
- 例外：
c.GetHeader()、c.Request.URL.Query()这类底层访问可随时用，但需手动类型转换和容错
c.ShouldBindQuery() 和 c.ShouldBind() 能用在过滤器里吗
可以，但要小心副作用和性能开销。这两个方法会强制解析对应数据源（query string 或 request body），并将结果绑定到结构体。一旦调用，后续 handler 再次调用相同绑定方法会复用缓存结果，但：
-
c.ShouldBindQuery()安全，适合校验分页、排序等通用 query 参数，例如：var req struct{ Page int `form:"page" binding:"required,min=1"` }; if err := c.ShouldBindQuery(&req); err != nil { c.AbortWithStatusJSON(400, gin.H{"error": "invalid query"}); return } -
c.ShouldBind()对 POST/PUT 请求可能提前读取并消耗c.Request.Body，导致下游 handler 再次读取失败（body 是单次流） - 若只需校验而不绑定，优先用
c.DefaultQuery()+ 手动转换，避免触发完整绑定流程
如何安全地做 query 参数白名单校验
不依赖结构体绑定，用 c.Request.URL.Query() 直接操作原始 query 值，既能绕过 Gin 缓存机制，又能精准控制校验粒度。
- 获取全部 query：
queries := c.Request.URL.Query()，返回url.Values（本质是map[string][]string） - 检查是否存在且非空：
if _, ok := queries["token"]; !ok { c.AbortWithStatusJSON(400, gin.H{"error": "missing token"}); return } - 限制允许的 key：
allowed := map[string]bool{"page": true, "limit": true, "sort": true}; for key := range queries { if !allowed[key] { c.AbortWithStatusJSON(400, gin.H{"error": "disallowed query param: " + key}); return } } - 注意：
queries["key"]返回切片，多值情况需按需取[0]或遍历
body 参数在前置过滤器里读取的唯一可靠方式
必须用 c.Request.Body 原生读取，并手动重置 c.Request.Body，否则下游 handler 会收不到数据。
- 示例（JSON body 校验）：
body, _ := io.ReadAll(c.Request.Body) c.Request.Body = io.NopCloser(bytes.NewBuffer(body)) var payload map[string]interface{} if err := json.Unmarshal(body, &payload); err != nil { c.AbortWithStatusJSON(400, gin.H{"error": "invalid JSON"}) return } if payload["env"] != "prod" { c.AbortWithStatusJSON(403, gin.H{"error": "env not allowed"}) return } - 关键点：
c.Request.Body必须重置为io.NopCloser，否则c.ShouldBindJSON()等会读到 EOF - 不推荐在过滤器里频繁解析 body，影响性能；敏感校验（如签名验证）除外
真正容易被忽略的是：query 参数校验放在前置过滤器里很自然，但 body 解析一旦出错或未重置 Body，整个请求链就静默失败——没有报错，只是下游拿不到数据。动手前先确认你是否真的需要在过滤器里碰 body。
