Go URL 编码 重复参数怎样保留

在 Go 里处理 ?tag=go&tag=web 这类查询串时，重复参数不会自动丢失，关键是不要把它当成普通的单值 map。net/url 的 url.Values 本质上把每个键映射到 []string：构造时用 Add 追加，读取全部值时直接访问切片，回写时用 Encode。只有在明确只需要一个值时，才使用 Get。

重复参数先用切片表达，再决定如何编码

url.Values 的数据模型已经为重复参数留出了位置。下面的示例分别演示追加、覆盖和编码结果：

package main

import (
    "fmt"
    "net/url"
)

func main() {
    values := url.Values{}
    values.Add("tag", "go")       // 追加第一个同名参数
    values.Add("tag", "web")      // 追加第二个值，不覆盖前一个
    values.Set("page", "2")       // 单值键直接设置

    fmt.Println(values["tag"])     // [go web]
    fmt.Println(values.Get("tag")) // Get 只取第一个值
    fmt.Println(values.Encode())    // page=2&tag=go&tag=web
}

如果把第二次 Add 写成 Set("tag", "web")，tag=go 就会被替换。Encode 会按键名排序输出，但同一个键的切片顺序仍按追加顺序保留；这正适合把参数重新拼回请求 URL。

解析时用 ParseQuery 保留全部值并接住错误

已有 URL 可以通过 url.ParseQuery 解析。对于 tag=go&tag=web&empty=，结果中的 values["tag"] 是 []string{"go", "web"}，空值也会保留为一个空字符串。

package main

import (
    "fmt"
    "net/url"
)

func main() {
    raw := "tag=go&tag=web&empty=&name=Go%20URL"
    values, err := url.ParseQuery(raw)
    if err != nil {
        // 先保留已解析的合法值，再决定是否拒绝这次请求
        fmt.Println("query parse error:", err)
        return
    }

    fmt.Println(values["tag"])   // [go web]
    fmt.Println(values["empty"]) // []
    fmt.Println(values.Get("name"))
}

URL.Query() 也能得到 Values，但它会忽略解析错误。如果输入来自客户端、代理或签名校验链路，建议先拆出 RawQuery，使用 ParseQuery 检查返回的 error，避免把异常参数当成正常空值继续处理。

读取和转发时不要把 Get 当成“全部参数”

常见的丢值点在过滤逻辑里：先用 Get 取出首项，再把它写回下游请求，实际上已经把后续值舍弃。转发多选项、标签或批量 ID 时，应复制切片并逐项 Add；不要直接修改共享的 Values，以免影响后续中间件。

几个容易混淆的边界需要单独测试

第一，Values 不是保留所有原始键值对顺序的列表。Encode 会按键名排序，所以如果签名协议要求保留不同键之间的原始出现顺序，应在解析前保存原始查询串，不能只依赖 Values。

第二，空值和缺失值不是一回事。empty= 通常会得到包含空字符串的切片，而没有这个键时读取结果可能是 nil。第三，非 URL 编码的分号会让 ParseQuery 返回错误；不要为了“尽量解析”而无条件忽略错误。

建议至少覆盖重复键、Set 覆盖、空值、百分号编码和非法分隔符五组用例。这样以后把查询参数接到缓存键、签名字符串或下游 API 时，重复参数是否保留会变成可回归的行为，而不是靠日志猜测。

相关问题

Go 的 url.Values 为什么适合保存重复参数？

因为它按键保存字符串切片，一个键可以对应多个值；Add 会追加，Encode 再把切片展开成多个同名参数。

Get 和 values[key] 应该怎么选？

业务明确只接受首个值时用 Get；多选项、批量 ID 或转发场景要读取 values[key]，并处理空切片或缺失键。

URL.Query 和 ParseQuery 有什么区别？

URL.Query 便于快速取值，但会静默丢弃格式错误；需要拒绝非法输入或记录解析问题时使用 ParseQuery 并检查错误。