本文介绍在 go 的 fasthttp 框架中正确提取 url 查询参数（如 ?key=value）的方法，重点说明 queryargs().peek() 的使用方式、与标准库的差异及常见注意事项。
本文介绍在 go 的 fasthttp 框架中正确提取 url 查询参数（如 ?key=value）的方法，重点说明 queryargs().peek() 的使用方式、与标准库的差异及常见注意事项。
在 fasthttp 中获取请求 URL 中的查询参数（query string）非常高效，但其 API 设计与 net/http 有明显区别：不能使用 Get() 方法（该方法在 fasthttp 的 QueryArgs 类型中并不存在），而应使用 ctx.QueryArgs().Peek("key")。
例如，对于请求 http://127.0.0.1:8080/x?haha=1，正确写法如下：
func handler(ctx *fasthttp.RequestCtx) {
// ✅ 正确：使用 Peek 获取单个参数值（返回 []byte，需转 string）
value := ctx.QueryArgs().Peek("haha")
if len(value) > 0 {
strValue := string(value) // 转为 string 后使用
ctx.WriteString("haha = " + strValue) // 输出: "haha = 1"
} else {
ctx.WriteString("haha not found")
}
}
⚠️ 注意事项：
- Peek() 返回的是 []byte（零拷贝设计，性能高），不是 string，需显式转换（string(val)）；
- 若参数不存在，Peek() 返回 nil（即 len(value) == 0），不可直接调用 string(nil)（虽不 panic，但得空字符串，逻辑易出错）；
- 如需获取所有同名参数（如 ?tag=a&tag=b），应使用 VisitAll() 或 Parse() 配合自定义解析；
- QueryArgs() 仅解析 query string（URL 中 ? 后部分），不包含 POST 表单或 JSON body；POST 参数需用 ctx.FormValue("key")；
- 所有 QueryArgs 方法均不进行 URL 解码——若参数含 %20 等编码，需手动调用 fasthttp.URI.DecodeArg() 处理（通常 Peek() 返回值已自动解码，但特殊场景建议验证）。
✅ 推荐封装工具函数提升可读性：
func getQueryArg(ctx *fasthttp.RequestCtx, key string) string {
b := ctx.QueryArgs().Peek(key)
if len(b) == 0 {
return ""
}
return string(b)
}
// 使用示例
haha := getQueryArg(ctx, "haha")
总结：fasthttp 为极致性能舍弃了部分语义化命名（如 Get → Peek），开发者需适应其零拷贝、字节切片优先的设计哲学。掌握 Peek()、VisitAll() 和 FormValue() 的适用边界，是构建高性能 HTTP 服务的关键基础。
