fiber中query参数与路径参数必须用不同方法获取：c.query("key")取字符串（自动解码、拼错返回空串），推荐用c.queryint/c.querybool等安全转换；多值用c.queries()；需注意大小写敏感、空值区分及反向代理配置。
查询参数（query string）和路径参数（:id）是两类完全独立的数据来源，Fiber 中必须用不同方法取 —— c.Query 系列函数专用于 query，不能混用 c.Params。
怎么用 c.Query 取字符串值
最常用的是 c.Query("key")，它返回 string 类型，未提供时默认为空字符串 ""，不会 panic。
- 比如请求
/search?q=go&page=2，c.Query("q")返回"go"，c.Query("page")返回"2" - 注意：它不自动做 URL 解码，但 Fiber 内部已调用
url.QueryUnescape，你拿到的就是解码后的结果 - 如果参数名拼错（如
c.Query("Q")），照样返回空字符串，不会报错 —— 容易漏判，建议配合c.IsQueryDefined("key")先检查是否存在
怎么安全地取整数、布尔等类型
c.Query 只返回字符串，类型转换得自己来；Fiber 提供了带默认值和错误处理的封装函数，推荐优先使用：
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
-
c.QueryInt("page", 1)：返回int，失败或未提供时用默认值1 -
c.QueryBool("debug", false)：识别"true"/"1"/"on"等为 true，其余（含空）为 false -
c.QueryFloat("timeout", 30.0)：转float64，失败时回退默认值 - 这些函数内部用
strconv转换，失败时不 panic，但如果你需要区分“未提供”和“转换失败”，就得用原始c.Query+ 手动strconv.Atoi并检查 error
多个同名参数怎么取（如 ?tag=a&tag=b&tag=c）
Fiber 不默认支持多值 query（像 req.URL.Query()["tag"] 那样返回 []string），但提供了 c.Queries() 方法：
-
c.Queries()返回map[string][]string，能完整拿到每个 key 对应的所有值 - 例如上例中，
c.Queries()["tag"]是[]string{"a", "b", "c"} - 注意：
c.Query("tag")只返回第一个值"a"，这是标准行为，不是 bug - 如果你只想要去重后的单值，别直接遍历
c.Queries()，先确认业务是否真需要多值语义 —— 大多数场景下，前端应控制只传一个
容易忽略的边界情况
query 解析发生在路由匹配之后，但它的行为受 URL 解析底层影响，几个实际踩过的坑：
- URL 中有未编码的空格、中文、特殊符号（如
{）？Fiber 会静默丢弃整个 query string 或截断，务必确保前端调用encodeURIComponent或后端用c.OriginalURL()检查原始路径 -
c.Query对大小写敏感：?ID=123和?id=123是两个键，c.Query("id")取不到前者 - 空值参数如
?page=，c.Query("page")返回""，和未提供参数表现一致，需靠c.IsQueryDefined("page")区分 - 如果用了反向代理（如 Nginx），确保它没 strip 掉 query string —— 常见配置遗漏是
proxy_pass末尾多了/导致 query 丢失
真正麻烦的从来不是“怎么取”，而是“取到的到底是不是用户本意”。query 参数没有 schema，没有必填约束，也没有类型保障 —— 所以哪怕用了 QueryInt，也建议在关键逻辑前加一道 if page 校验。Fiber 给你的是工具，不是契约。
