Go 问答：http.Request.URL.Query 读取重复参数时如何保留顺序并区分空值

处理筛选接口时，`?tag=go&tag=web&tag=` 这类查询串并不少见。Go 的 `http.Request.URL.Query()` 会把它解析成 `url.Values`：同名参数对应一个字符串切片，切片顺序就是它们在原始查询串中的出现顺序；而 `tag=` 与完全没有 `tag`，需要用两值接收来区分。

要保留重复参数的顺序，就读取 `values["tag"]` 的整个切片；要区分缺失和显式空值，用 `value, ok := values["tag"]`，不要只看 `Get` 的返回字符串。

先看 Query 的返回值到底保存了什么

URL.Query() 调用的是 url.ParseQuery，结果类型为 url.Values。可以把它理解为“一个键对应多个值”的表，而不是普通的 map[string]string。

raw := "tag=go&tag=web&tag="
values := req.URL.Query()
fmt.Printf("%#v\n", values["tag"])
// []string{"go", "web", ""}

这里的三个元素分别对应三个 tag。最后的空字符串不是参数丢失，而是调用方明确传了一个没有内容的值。

重复参数要用切片读取，Get 只适合单值约定

如果接口契约允许多个标签、多个排序字段或多个权限范围，直接调用 Get 会悄悄丢掉后面的值。Get 的语义是取该键的第一个值，不是合并全部值。

values := req.URL.Query()
tags := values["tag"]
for _, tag := range tags {
    fmt.Println(tag)
}

first := values.Get("tag")
fmt.Println("first:", first)

对于示例查询串，循环依次输出 go、web、空行，而 first 只有 go。这也是保留调用方顺序最直接的写法：不要先转成无序集合，也不要用逗号再次拼接后解析。

缺失、空值和空切片不是一回事

下面三种输入在业务上可能代表三种不同意图：

tags, exists := values["tag"]
switch {
case !exists:
    // 没有 tag
case len(tags) == 1 && tags[0] == "":
    // 明确传入了空 tag
default:
    // tags 保留重复值和顺序
}

注意不要只写 if values.Get("tag") == ""。它无法区分“键不存在”和“键存在但值为空”，并且也看不到第二个及之后的值。

上线前用表驱动测试固定边界

查询解析属于输入边界，适合用 url.Parse 配合表驱动测试验证。测试重点不是 URL 是否能打开，而是业务层拿到的键和值是否符合接口约定。

func TestQueryTags(t *testing.T) {
    cases := []struct {
        raw   string
        want  []string
        exist bool
    }{
        {"/items", nil, false},
        {"/items?tag=", []string{""}, true},
        {"/items?tag=go&tag=web", []string{"go", "web"}, true},
    }
    for _, tc := range cases {
        u, _ := url.Parse(tc.raw)
        got, ok := u.Query()["tag"]
        if !reflect.DeepEqual(got, tc.want) || ok != tc.exist {
            t.Fatalf("raw=%q got=%#v,%v want=%#v,%v", tc.raw, got, ok, tc.want, tc.exist)
        }
    }
}

真实项目里还应补上 URL 编码、空键和非法百分号等输入，并明确服务是否允许重复键。解析成功不等于业务输入合法，白名单和数量上限仍应在业务层执行。

相关问题：几个容易混淆的读取场景

Query 会修改原来的 Request URL 吗？

不会。它根据当前 RawQuery 解析并返回一个 url.Values。修改返回的 map 不会自动回写请求；需要改变 URL 时，应显式设置 req.URL.RawQuery。

多个值能不能直接用逗号拼接？

不建议。逗号可能本来就是合法值的一部分，而且会丢失原始边界。优先保留 []string，在确定协议后再做明确编码。

什么时候可以用 Get？

当接口明确规定一个键只有一个值，并且缺失与空值不需要区分时，Get 简洁可靠；否则使用切片和存在标记。

最后把读取规则写进接口约定

这类问题的核心不是记住某个方法，而是把参数基数写清楚：单值参数用 Get，多值参数用 values[key]，需要识别是否提交则保留第二个返回值。这样重复参数的顺序、空值语义和缺失行为都会在代码和测试里留下证据。