在Go语言构建的Web应用里，URL参数与查询字符串是最基础的数据输入来源。无论是REST接口还是页面路由，客户端经常通过问号后的键值对传递筛选条件、分页信息或回调地址。Go在标准库中提供了完善的处理机制，开发者不需要依赖第三方框架也能完成解析、读取与重组。
一、URL结构与net/url包基础
Go的net/url包定义了URL结构体，其中RawQuery字段保存未解析的查询字符串，而Query方法会将其解析为url.Values类型。url.Values本质上是map[string][]string，这意味着同一个参数名可以对应多个值，符合HTTP规范中重复键的写法。
使用url.Parse可以将字符串转为URL对象。需要注意该函数返回的错误不代表字符串非法就完全不可用，某些边缘情况只会填充部分字段。在Web服务中，通常我们直接使用http.Request已经解析好的URL字段，而不必自己调用Parse。
package main
import (
"fmt"
"net/url"
)
func main() {
raw := "https://ipipp.com/search?keyword=golang&page=2&tag=web&tag=backend"
u, err := url.Parse(raw)
if err != nil {
panic(err)
}
// 解析查询字符串
values := u.Query()
fmt.Println(values.Get("keyword")) // 输出 golang
fmt.Println(values["tag"]) // 输出 [web backend]
}
二、从HTTP请求中读取参数
在net/http处理器中，请求的URL字段已经是解析过的对象。调用r.URL.Query()即可获得本次请求的所有查询参数。这种方式比直接读取r.URL.RawQuery再手动切割安全得多，因为它自动处理了百分号编码，例如中文或空格被编码为%E4%B8%AD或+的情况。
对于只关心单个参数的场景，url.Values提供了Get方法，它永远返回该参数第一个值；若参数不存在则返回空字符串。如果需要全部值，直接以 map 下标方式访问即可。下面的示例展示了一个简单的处理器，根据查询参数返回不同内容。
package main
import (
"fmt"
"net/http"
)
func handler(w http.ResponseWriter, r *http.Request) {
query := r.URL.Query()
name := query.Get("name")
if name == "" {
name = "匿名"
}
// 获取多值参数
hobbies := query["hobby"]
fmt.Fprintf(w, "用户:%s 爱好:%v", name, hobbies)
}
func main() {
http.HandleFunc("/", handler)
http.ListenAndServe(":8080", nil)
}
三、修改与构造查询字符串
除了读取，我们常常需要修改参数并生成新的URL，例如分页跳转或签名拼接。url.Values支持Set、Add、Del等方法。Set会覆盖已有值，而Add在原键上追加新值。修改完成后，通过Encode方法将其序列化为合法的查询字符串，空格会被转为加号。
要注意Encode的结果可以直接赋值给URL.RawQuery，再调用String得到完整链接。若手动拼接字符串容易遗漏编码步骤，导致服务器解析异常。以下代码演示如何基于原请求生成下一页链接。
package main
import (
"fmt"
"net/url"
)
func nextPage(raw string) string {
u, _ := url.Parse(raw)
q := u.Query()
// 当前页
page := q.Get("page")
if page == "" {
page = "1"
}
// 简单自增，实际应转成整数
q.Set("page", page+"1")
u.RawQuery = q.Encode()
return u.String()
}
func main() {
link := nextPage("https://ipipp.com/list?page=1&sort=desc")
fmt.Println(link)
}
四、常见误区与编码差异
一个容易混淆的点是加号与百分号编码的关系。在查询字符串中，加号+被解释为空格，这是HTML表单提交的历史约定；而在URL路径其他部分，空格必须写成%20。Go的Query方法遵循该规则，但如果你用Path部分传参就可能出错。
另一个误区是认为Get方法能区分空值与不存在。实际上两者都返回空字符串，严谨的写法是用下标访问判断 slice 是否为 nil。同时在处理用户输入的URL时，应始终检查Parse错误，避免相对路径或非法字符引起后续逻辑崩溃。
| 操作 | 方法 | 特点 |
|---|---|---|
| 读取单值 | Values.Get(key) | 返回首个，不存在返回空 |
| 读取多值 | Values[key] | 返回字符串切片 |
| 覆盖写 | Values.Set(key, val) | 清空旧值再设 |
| 追加写 | Values.Add(key, val) | 保留旧值 |
| 序列化 | Values.Encode() | 百分号编码，空格转加号 |
五、在中间件中统一处理参数
实际项目中，我们可以在中间件里提前解析并校验查询参数，将清理后的数据放入上下文。这样下游处理器不必重复调用Query，也方便集中记录日志。下面的例子展示了一个简单的中间件，它把分页参数限制在一定范围内。
这种封装提升了代码复用率，同时让业务逻辑更关注核心流程。结合context包，可以把解析后的参数传递下去，避免在每个处理函数里写重复的判断代码。
package main
import (
"net/http"
"strconv"
)
func paginationMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
q := r.URL.Query()
page := 1
if v := q.Get("page"); v != "" {
if n, err := strconv.Atoi(v); err == nil && n > 0 {
page = n
}
}
if page > 100 {
page = 100
}
q.Set("page", strconv.Itoa(page))
r.URL.RawQuery = q.Encode()
next.ServeHTTP(w, r)
})
}
通过上述方式，Golang对URL参数与查询字符串的处理既规范又灵活。掌握net/url与net/http的协作，能让我们在面对各种客户端输入时保持服务稳定。