Go net/url 如何保留重复查询参数的顺序

接口里出现 ?tag=go&tag=web&sort=latest 时，Go 的 net/url 不会把重复的 tag 覆盖掉。正确做法是读取 u.Query()["tag"] 得到 []string，再用 Values.Add 按顺序追加；不要用 Get 代替多值读取，也不要误以为 Values.Encode 能恢复所有参数的原始交错顺序。

重复键要读切片，Get 只拿第一个值

url.Values 的本质是 map[string][]string：key 是参数名，切片是这个名字出现过的所有值。URL.Query 会解析 RawQuery，因此同名参数会依次进入切片。使用 Get 时只会得到第一个值，适合单值参数；筛选标签、批量 ID、权限范围这类参数应直接访问 map。

package main

import (
    "fmt"
    "net/url"
)

func main() {
    u, err := url.Parse("https://example.com/items?tag=go&tag=web&sort=latest")
    if err != nil {
        panic(err) // 示例中直接终止；服务代码应把解析错误返回给调用方
    }

    values := u.Query()
    tags := values["tag"] // 直接读取切片，保留同名值的出现顺序
    fmt.Println(tags)
    fmt.Println(values.Get("tag")) // Get 只返回第一个值
}

[go web]
go

用 Add 重建时，同一个 key 的值顺序不会丢

要追加重复参数，用 Add，它会把新值放到已有切片末尾；Set 则会替换原有切片。重建 URL 时把 Encode 的结果写回 RawQuery，即可得到合法的 URL 编码。

func rebuild(tags []string) (string, error) {
    values := url.Values{}
    for _, tag := range tags {
        values.Add("tag", tag) // Add 追加，不覆盖前面已经保存的 tag
    }
    values.Set("sort", "latest") // Set 只用于确定唯一值的参数

    u := url.URL{Scheme: "https", Host: "example.com", Path: "/items"}
    u.RawQuery = values.Encode() // Encode 负责转义，并按 key 排序
    return u.String(), nil
}

这里的“保序”有一个边界：tag=go&sort=latest&tag=web 经过 Values 后只记得 tag 有两个值、sort 有一个值。重新 Encode 时会先输出排好序的 key，再输出各 key 的值，所以不能还原 tag 与 sort 原来交错出现的位置。

需要原始交错顺序时，保留 RawQuery

如果业务在做签名、审计记录、代理转发或缓存键比较，关注的不是“参数语义相同”，而是原始字符序列，那么 RawQuery 才是正确边界。URL.Query 还会静默丢弃格式错误的参数对；需要检查解析错误时改用 url.ParseQuery 并处理返回的 error。

func rawQuery(u *url.URL) (string, error) {
    if u == nil {
        return "", fmt.Errorf("URL 不能为空") // 避免空指针并让调用方决定如何处理
    }
    return u.RawQuery, nil // 原样保留，不经过 map、排序或重新转义
}

常见问题

为什么 Encode 后参数顺序变了？

因为 Values.Encode 按 key 排序，这是它的稳定输出规则；它只保证同名值按切片顺序输出，不承诺恢复不同 key 的原始交错位置。

如何删除重复参数中的一个值？

先复制或取得切片，按业务条件过滤后重新赋值；不要用 Del，因为 Del 会删除整个 key 对应的所有值。

Query 和 ParseQuery 该选哪个？

只关心常规读取时用 Query 更直接；要发现格式错误并做明确处理时使用 ParseQuery，检查它返回的 error。