Go URL 查询参数怎么区分空值、缺失值和重复值

在 Go 里，url.Values.Get 返回空字符串，并不能说明参数缺失：?q= 和完全没有 q 都可能得到 ""。要区分查询参数的状态，应先用 map 查键是否存在，再根据切片长度判断是否重复；需要错误信息时使用 url.ParseQuery，不要只调用 URL.Query。

实用判断规则是：!ok 表示缺失，ok && values[0] == "" 表示存在但为空，长度大于 1 表示重复传参。Get 适合“只取首值”，不适合做存在性判断。

为什么 Get 不能判断空值和缺失值

url.Values 本质上是 map[string][]string。因此，同一个键可以对应多个值，也可以只对应一个空字符串。Get 的契约是取第一个值；键不存在时也返回空字符串，所以它主动隐藏了“键是否出现”这层信息。

package main

import (
    "fmt"
    "net/url"
)

func describe(values url.Values, key string) {
    items, ok := values[key]
    switch {
    case !ok:
        fmt.Printf("%s: 缺失\n", key)
    case len(items) > 1:
        // 直接读切片，保留重复参数的顺序和值。
        fmt.Printf("%s: 重复值 %q\n", key, items)
    case items[0] == "":
        // 键存在但内容为空，与键完全缺失是两种业务状态。
        fmt.Printf("%s: 存在但为空\n", key)
    default:
        fmt.Printf("%s: 单值 %q\n", key, items[0])
    }
}

func main() {
    values, err := url.ParseQuery("q=&tag=go&tag=web")
    if err != nil {
        fmt.Println("解析失败:", err)
        return
    }
    describe(values, "q")
    describe(values, "page")
    describe(values, "tag")
}

这里的 q 会进入“存在但为空”分支，page 进入“缺失”分支，tag 保留两个值。若只是要判断键出现过没有，也可以写成 values.Has("q")；但要处理重复值，仍应读取 map 中的切片。

需要错误信息时用 ParseQuery

服务端收到请求后，r.URL.Query() 很方便，但它会静默丢弃格式错误的值对。比如某个参数含有不完整的百分号编码，调用者只看到剩下的有效参数，可能误把“输入错误”当成“参数缺失”。需要记录或返回 400 时，应直接把 RawQuery 交给 ParseQuery。

raw := "q=go%2Bnet&tag=web&broken=%ZZ"
values, err := url.ParseQuery(raw)
if err != nil {
    // ParseQuery 仍保留已成功解析的键，同时返回首个解码错误。
    fmt.Println("查询串存在编码错误:", err)
}
if values.Has("q") {
    fmt.Println("q:", values.Get("q"))
}

ParseQuery 返回的 map 非空时，仍然可以消费合法参数；是否继续处理要由接口契约决定。对严格接口，可以记录错误后直接拒绝；对兼容旧客户端的接口，则应明确哪些字段可以降级，避免悄悄丢数据。

编码、重复值和写回规则要分开

读取和构造查询串的语义也不同。Add 会追加一个值，适合 tag=go&tag=web 这类多选参数；Set 会替换该键原有的全部值，适合只允许一个筛选条件的场景。最后调用 Encode，不要手动拼接未转义的空格、加号或中文。

values := url.Values{}
values.Add("tag", "go")
values.Add("tag", "web")
values.Set("page", "2")
values.Set("keyword", "go net/url")

// Encode 统一完成键排序与查询值转义，再交给 URL 使用。
query := values.Encode()
fmt.Println(query)

查询值里的加号和空格尤其容易混淆：查询编码会把空格编码为 +，读取时再还原为空格；真正想传递字面量加号时，应让 Encode 把它编码为 %2B。因此，参数值先放进 Values，再统一编码，比字符串拼接更稳妥。

把三种状态映射到接口策略

分页参数通常可以把缺失解释为默认页码，把存在但为空视为输入错误；筛选参数则可能把空值解释为“清除筛选”。对于多选参数，先检查切片长度，再决定是否去重、保序或拒绝重复。最重要的是把这个选择写在接口代码里，而不是依赖 Get 返回的空字符串来猜。

常见问题

Values.Has 发现空参数了吗？

会。只要键存在，哪怕查询串是 ?q=，Has("q") 也返回 true；值是否为空要继续读取切片。

为什么 URL.Query 后没有报错？

这是它的设计：Query 为便捷读取而静默丢弃格式错误的值对。需要错误信息时改用 ParseQuery。

记住“键存在性、值数量、编码错误”是三件事：用 map 或 Has 判断第一件，用切片判断第二件，用 ParseQuery 处理第三件。这样空值、缺失值和重复值就不会在业务层被压成同一个空字符串。