Go net/url.Values 怎样区分参数缺失和空值

先说结论：url.Values.Get 在“参数不存在”和“参数存在但值为空”时都会返回空字符串，单独使用它无法保留这两种语义。需要区分时，用 Values.Has 判断键是否出现；如果还要处理重复参数，就直接读取 values[key] 得到完整的字符串切片。

官方文档：https://pkg.go.dev/net/url#Values

下面把查询字符串 ?name=go、?name= 和没有 name 三种输入放在一起比较，最后封装成一个可以复用的解析函数。

先看 Get 为什么无法区分两种空字符串

Values 的底层类型是 map[string][]string。官方文档规定，Get 返回指定键关联的第一个值；没有关联值时也返回空字符串。因此下面两次调用的结果相同，但来源不同：

package main

import (
    "fmt"
    "net/url"
)

func main() {
    missing := url.Values{}
    explicitEmpty := url.Values{"name": {""}}

    // Get 只给出第一个字符串，无法告诉调用方键是否出现过。
    fmt.Printf("missing=%q empty=%q\n", missing.Get("name"), explicitEmpty.Get("name"))
}

所以如果业务把空字符串解释成“用户明确清空”，而把缺失解释成“沿用默认值”，只调用 Get 就会丢失必要信息。

用 Has 判断键是否出现

Has 检查给定键是否被设置，不关心它的值是不是空字符串。组合 Has 与 Get，就能得到最常用的三态判断：

func readName(values url.Values) (string, bool, error) {
    // false 表示调用方没有提交 name，交给上层使用默认值。
    if !values.Has("name") {
        return "", false, nil
    }

    value := values.Get("name")
    if value == "" {
        // true 加空字符串表示键出现了，但用户明确传了空值。
        return "", true, fmt.Errorf("name 不能为空")
    }
    return value, true, nil
}

这里的两个返回值分别表示“是否出现”和“具体值”。如果业务允许显式空值，也可以把错误分支改成清空配置或删除字段，而不是统一当成缺失。

直接读取切片处理多值和空值

当请求可能包含 ?tag=go&tag=http 时，Get 只返回第一个值。直接读取 map 可以保留重复参数的顺序和空值：

func readTags(values url.Values) ([]string, bool, error) {
    raw, ok := values["tag"]
    if !ok {
        // 键不存在：让调用方决定是否使用默认标签。
        return nil, false, nil
    }
    if len(raw) == 0 {
        // 防御性处理：键存在但切片为空时，不把它误认为一个标签。
        return nil, true, fmt.Errorf("tag 没有可用值")
    }

    // 逐个检查，避免 tag=go&tag= 进入后续业务。
    for _, tag := range raw {
        if tag == "" {
            return nil, true, fmt.Errorf("tag 不能是空值")
        }
    }
    return raw, true, nil
}

如果只需要判断键是否存在，Has 更直观；如果要区分重复参数、空切片和每一个值，使用 map 下标的第二个返回值和切片长度更可靠。

把 ParseQuery 的错误纳入处理

手工接收原始查询字符串时，先处理 ParseQuery 的错误，再读取 Values。解析器会返回已经找到的合法参数，同时通过错误值报告第一个解码问题，不能因为 map 非空就忽略错误：

func parseQuery(raw string) (url.Values, error) {
    values, err := url.ParseQuery(raw)
    if err != nil {
        // 解析错误可能意味着调用方提交了非法编码或分隔符。
        return nil, fmt.Errorf("解析查询参数失败: %w", err)
    }
    return values, nil
}

在 HTTP 请求中，通常可以使用 r.URL.Query() 获得 url.Values；无论来源是哪一种，后续判断规则都相同：先判断键是否出现，再决定是否允许空值，最后按需要读取全部值。

常见问题

Get 返回空字符串时，能直接当成参数缺失吗？

不能。如果业务允许用户明确提交空值，应该先调用 Has 或读取 map；只有业务明确规定空值和缺失等价时，才可以直接使用 Get。

Has 为 true 就代表有非空内容吗？

不代表。它只说明键出现过，?name= 仍会得到 true。非空校验需要另外检查 Get 的结果或遍历切片。

重复参数应该用 Get 还是直接取 map？

只接受第一个值时用 Get；需要保留全部值、检查空项或实现多选参数时直接读取 values[key]。

总结：把“键是否出现”和“值是什么”拆成两个问题。Has 负责存在性，Get 负责单值读取，map 下标负责多值和完整空值语义；再把 ParseQuery 的错误提前处理，参数边界就不会被一个空字符串混在一起。