c.Query 用于获取单个查询参数，返回字符串且不自动类型转换，需手动校验空值和转换类型；重复键需用 c.Queries() 获取全部值；常见失效原因包括 URL 片段、代理未透传、前端未正确拼接及编码问题。
如何用 c.Query 获取单个查询参数
直接调用 c.Query 是最常用方式，它返回字符串，默认值为空字符串。注意：它不会做类型转换，也不会报错——传入不存在的 key 就返回空串，容易掩盖逻辑错误。
常见错误现象：c.Query("page") 返回空字符串，但业务上误以为是 “1”，结果查了第 0 页或跳过分页逻辑。
- 使用前务必检查是否为空：
if pageStr := c.Query("page"); pageStr != "" { ... } - 需要整数时，必须手动用
strconv.Atoi转换，且要处理错误 - 它对 URL 编码自动解码（如
%20→ 空格），这点比原生net/http的r.URL.Query().Get更省心
如何安全地解析带默认值和类型的查询参数
c.Query 不提供默认值或类型转换，得自己封装。Fiber 没有内置的 QueryInt 或 QueryBool，但你可以用 c.Queries() 批量取再处理，或写一个轻量工具函数。
推荐做法：对关键参数（如分页、状态过滤）单独校验并赋予默认值。
立即学习“go语言免费学习笔记（深入）”；
Golang Samber Hot
下载
在 Golang 中使用 samber/hot 进行内存缓存，支持 LRU、LFU、TinyLFU、W‑TinyLFU、S3FIFO、ARC、TwoQueue、SIEVE、FIFO 等淘汰算法，提供 TTL、缓存加载器及分片功能。
- 分页示例：
pageStr := c.Query("page") page := 1 if pageStr != "" { if p, err := strconv.Atoi(pageStr); err == nil && p > 0 { page = p } } - 布尔参数别信
"false"字符串：用strings.EqualFold(c.Query("active"), "true")，而不是strconv.ParseBool（它会把"false"解析为true） - 避免反复调用
c.Query同一个 key —— 多次解析开销小但语义混乱，建议一次取、一次转、变量复用
如何处理重复键（如 ?tag=go&tag=web）
Fiber 的 c.Query 只返回第一个值；要获取全部，必须用 c.Queries()，它返回 map[string][]string。
典型场景：多选过滤（?category=dev&category=ops）、标签列表（?tag=golang&tag=fiber&tag=api）。
-
c.Queries()["tag"]返回[]string{"golang", "fiber", "api"} - 注意：如果 URL 中只有
?tag=（无值），对应切片里会是[""]，不是nil，判空要用len(vals) > 0 - 不要直接用
c.Query("tag")替代，它永远只拿第一个，容易漏数据
为什么 c.Query 有时拿不到参数？排查要点
不是代码写错，往往是请求本身或中间件干扰导致的。常见原因比想象中更琐碎。
- URL 中用了
#片段标识符（如/api/list?page=2#section1）：浏览器根本不会把#后内容发给服务端，c.Query必然为空 - 反向代理（如 Nginx）配置了
proxy_pass但没透传完整 query string，检查$args或加proxy_set_header X-Original-URL $scheme://$host$request_uri; - 前端发请求时用了
URLSearchParams但没拼到 URL 上，而是塞进了 body 或 header —— Fiber 的c.Query只读 URL 查询字符串 - Fiber v2.45+ 默认启用严格模式，如果 query key 包含未编码的空格或特殊字符（如
?q=hello world），可能被丢弃；应确保前端用encodeURIComponent编码
query 参数看似简单，但和前端编码、代理转发、URL 解析边界耦合紧密，出问题时优先确认「参数到底有没有进 Fiber 路由层」，而不是立刻怀疑代码逻辑。
