query参数获取不生效需先确认请求方法和参数位置：get请求的query参数必须在url ?后，post等请求体数据不能用c.query()获取；c.query()返回空字符串时，应检查是否误用于非get请求或参数未正确编码。
Query参数获取不生效？先确认请求方法和参数位置
GET 请求的 query 参数必须出现在 URL 的 ? 后面，比如 /api/user?id=123&name=foo。如果用 POST 发送 JSON 数据却试图用 Query 方法取值，自然拿不到——c.Query() 只读 URL 中的 query string，不解析 body。
常见错误现象：c.Query("id") 返回空字符串，但 c.PostForm("id") 或 c.ShouldBindJSON() 才是正确路径。
- GET / PUT / DELETE 请求才适合用
Query系列方法 - POST / PATCH 若带 query（如
/api/update?id=1），仍可用Query，但 body 需另处理 - URL 编码问题：中文或特殊字符必须被编码，否则
c.Query()解析失败（浏览器自动编码，curl 要加-G或手动 urlencode）
c.Query() 和 c.DefaultQuery() 有什么区别？
c.Query() 在 key 不存在时返回空字符串；c.DefaultQuery("page", "1") 允许设默认值，避免后续做空判断。二者都只取第一个同名参数（?page=1&page=2 → 取 "1"）。
如果需要取全部同名参数，必须用 c.Request.URL.Query()["key"]，它返回 []string。
-
c.Query("sort")→string，安全但丢失重复项 -
c.DefaultQuery("limit", "10")→ 更简洁的带默认逻辑 - 要支持
?tag=golang&tag=web这种多值场景，直接访问c.Request.URL.Query()
如何一次性绑定多个 query 参数到结构体？
Gin 提供 c.ShouldBindQuery(&v)，底层用反射匹配 struct tag（默认 form tag，但 query 绑定也认它）。注意：它只从 query string 取值，不合并 body 或 header。
type SearchInput struct {
Page int `form:"page" binding:"required,min=1"`
Q string `form:"q"`
Order string `form:"order" default:"desc"`
}
var input SearchInput
if err := c.ShouldBindQuery(&input); err != nil {
c.JSON(400, gin.H{"error": err.Error()})
return
}
- 字段 tag 必须是
form，不是json或query -
binding规则同样生效（如required、min） - 未提供值的字段按 Go 零值初始化，
defaulttag 可覆盖零值（仅对基本类型有效） - 嵌套结构体不支持自动展开，query 不支持点号语法（
?user.name=foo不会绑定到User.Name）
Query 参数类型转换容易踩哪些坑？
Gin 没有内置 QueryInt 这类方法，所有 Query* 都返回字符串，转数字/布尔需手动处理。别直接用 strconv.Atoi(c.Query("id"))，没校验易 panic。
- 推荐用
c.GetInt("id")或c.GetInt64("id")—— 它们内部做了strconv+ 错误忽略，失败时返回 0 - 但 0 可能是合法值，所以更稳妥的是用
c.GetFloat64("price")+ 判断第二个返回值ok -
c.GetBool("active")识别"1"、"t"、"T"、"true"、"TRUE"、"on"、"ON"，其余为 false —— 注意不是任意非空即真 - 时间类参数（如
?since=2024-01-01）必须手动用time.Parse()，Gin 不处理
Query 参数永远是字符串来源，类型转换这一步没法跳过，也别指望框架替你做业务级校验。最常被忽略的是：前端传了空字符串 ?page=，GetInt 返回 0，而你本意是“未提供”，结果当成第 0 页处理了。
