Go net/url 解析重复查询参数时怎么保留全部值

接口筛选常把多个值放在同一个 query 键里，例如 ?tag=go&tag=http&tag=testing。Go 的 net/url 不会把它们合并成一个字符串，而是放进 url.Values 的字符串切片。要保留全部值，读取时使用 values["tag"]，不要只调用 values.Get("tag")。

解析重复查询参数的关键是记住：Get 只返回第一个值，直接访问 Values 才能拿到完整切片；修改时用 Add 追加，用 Set 覆盖。

Values 为什么能保留同名参数的多个值

url.Values 的类型是 map[string][]string：一个键对应一组字符串。调用 u.Query() 时，query 部分会被解码并按键归组，所以同名键自然落在同一个切片里。比如三个 tag 会得到三个元素，而不是只剩最后一个。

这里有一个容易误判的区别：

解析重复参数时直接读取切片并保留顺序

下面的例子把三个标签解析成切片，再逐个传给业务层。直接索引前要检查键是否存在；如果接口允许空值，还要明确空字符串是否算一个有效选项。

package main

import (
    "fmt"
    "log"
    "net/url"
)

func main() {
    raw := "https://example.test/search?tag=go&tag=http&tag=testing"
    u, err := url.Parse(raw)
    if err != nil {
        log.Fatal(err) // URL 语法错误时不要继续读取 query。
    }

    values := u.Query()
    tags, ok := values["tag"]
    if !ok {
        fmt.Println("没有 tag 参数") // 键不存在与存在但值为空是两个状态。
        return
    }

    fmt.Println(values.Get("tag")) // 只打印第一个值：go。
    for i, tag := range tags {
        fmt.Printf("tag[%d]=%s\\n", i, tag) // 切片遍历能保留客户端给出的顺序。
    }
}

如果只需要一个值，Get 很方便；如果要做白名单匹配、批量查询或把参数原样转发，就应使用完整切片。不要用普通 map 的“最后一次赋值”思路覆盖它，否则会丢掉前面的筛选条件。

修改多值参数时用 Add，覆盖才用 Set

读取后如果还要增加一个标签，调用 Add；如果业务规则是“新筛选条件完全替换旧条件”，才调用 Set。两者都作用于同一个键，但结果完全不同。

package main

import (
    "fmt"
    "net/url"
)

func main() {
    values := url.Values{}
    values.Add("tag", "go") // Add 追加，不会删除已有 tag。
    values.Add("tag", "http")
    values.Set("page", "2") // Set 适合单值键，重复调用只保留最后一次。

    values.Add("tag", "testing")
    fmt.Println(values["tag"]) // [go http testing]
    fmt.Println(values.Encode()) // page=2&tag=go&tag=http&tag=testing
}

Encode 会对键和值做 query 编码，并按键排序；同一个键对应的多个值仍会重复输出。若要把修改写回 URL，需要显式赋给 u.RawQuery，否则只改了内存中的 Values，原 URL 字符串不会变化。

ParseQuery 的错误和空值边界怎么处理

u.Query() 适合从已解析的 URL 读取；如果手里只有 query 字符串，可以使用 url.ParseQuery。它会返回已经解析出的有效参数，同时通过错误值报告遇到的第一个解码错误。生产接口不要忽略这个错误，也不要在没有长度限制的情况下接受任意多的重复键。

package main

import (
    "fmt"
    "net/url"
)

func main() {
    values, err := url.ParseQuery("tag=go&tag=&bad=%ZZ")
    if err != nil {
        fmt.Println("query 解码失败：", err) // 非法百分号编码需要交给调用方处理。
    }
    fmt.Printf("tag=%q\\n", values["tag"]) // 有效部分可能已经被解析出来。
}

空值 tag= 与缺少 tag 不应混为一谈：前者可能表示用户主动清空筛选，后者表示没有提交该条件。最终采用哪种语义，要由接口契约决定。

相关问题

Set 为什么会让重复参数只剩一个？
因为 Set 会把该键替换成只包含新值的切片；要保留旧值并增加新值，使用 Add。

Encode 会不会丢掉重复值的顺序？
它会按键排序，但同一键的切片值会依次编码。不要依赖不同键之间的输出顺序；如果业务关心重复值顺序，应在同一个键的切片中处理。