在Go语言开发的HTTP服务中，客户端经常通过查询字符串传递数组数据。例如列表筛选场景里，前端希望把多个选中的分类编号发给后端，最常见做法是让同一个参数名重复出现。服务端需要从原始请求里把这些重复键收集成切片，而不是只留末次赋值。理解Go标准库对查询串的解析机制，是写出稳定接口的第一步。
标准库net/url的解析机制
Go的net/url包提供了ParseQuery函数，它能够把查询字符串解析为url.Values类型。url.Values本质是一个map[string][]string，也就是说，每一个键天然就对应着一个字符串切片。当同一个参数名在查询串里出现多次时，标准库并不会覆盖前面的值，而是依次追加到切片中。这一点和某些语言默认只取最后一个值的逻辑不同，也是Go处理数组查询串的底层优势。
我们可以通过一段简单代码来验证这个行为。下面的示例模拟了ids=1&ids=2&ids=3这样的输入，并打印出解析后的切片内容。
package main
import (
"fmt"
"net/url"
)
func main() {
query := "ids=1&ids=2&ids=3"
values, err := url.ParseQuery(query)
if err != nil {
panic(err)
}
fmt.Println(values["ids"])
}
运行上述程序会输出[1 2 3]，说明标准库已经帮我们完成了数组的聚合。需要注意的是，如果参数只出现一次，比如ids=5，那么切片里就只有一个元素，类型上仍然是[]string，调用方无需做特殊分支判断。这种一致性让业务代码更简洁，也避免了手动分割字符串带来的空指针风险。
手动切割与标准库方案的对比
有些老项目为了兼容特定格式，会绕过url.ParseQuery，自己用strings.Split按&切分后再按=取键值。这种做法在简单场景下看似直观，但一旦遇到值里包含转义字符、加号表示空格、或者参数名带方括号等情况，手写逻辑就很容易出错。例如浏览器发出的空格常被编码为加号，标准库会自动把加号还原成空格，而手动切割若忘记处理，就会导致数据偏差。
我们来看看一个典型的错误手写实现以及它的问题所在。
package main
import (
"strings"
)
func parseManual(query string) map[string]string {
result := make(map[string]string)
pairs := strings.Split(query, "&")
for _, p := range pairs {
kv := strings.SplitN(p, "=", 2)
if len(kv) == 2 {
result[kv[0]] = kv[1]
}
}
return result
}
上面的函数返回的是map[string]string，当ids重复时后面的直接覆盖前面的，数组结构彻底丢失。即便改成map[string][]string并做追加，也要自己处理url.QueryUnescape解码，开发成本变高且容易遗漏边界。因此，除非有极其特殊的协议格式，否则应优先使用标准库，把解析正确性交给经过广泛测试的运行时。
常见误区与健壮解析实践
第一个常见误区是认为方括号命名如ids[]=1&ids[]=2才能表示数组。实际上HTTP查询串并没有强制规定数组必须带方括号，重复键名本身就是合法的数组表达。如果前端用了方括号，Go解析后键名会原样变成ids[]，业务代码取values["ids[]"]即可，不需要额外去掉括号。第二个误区是忽略url.Values.Get方法，该方法只返回切片第一个元素，若误用就会拿不到完整数组，应当直接用切片下标或遍历。
下面给出一个更贴近真实服务的封装函数，它从*http.Request中取出查询值并转成int切片，同时处理了空值与转换失败的情况。
package main
import (
"net/http"
"strconv"
)
func parseIDArray(r *http.Request) ([]int, error) {
values := r.URL.Query()
raws := values["ids"]
if len(raws) == 0 {
return []int{}, nil
}
result := make([]int, 0, len(raws))
for _, s := range raws {
n, err := strconv.Atoi(s)
if err != nil {
return nil, err
}
result = append(result, n)
}
return result, nil
}
这个函数在控制器里调用时，能稳定地把查询串里的多个ids转成整型数组。如果前端传了非法值比如ids=abc，函数会返回错误，服务端可据此返回400状态码。相比在业务逻辑里反复写解析代码，统一收口到此类辅助方法中，既减少了重复，也方便后续加入默认值或上限校验。对于包含数组的查询字符串，把握标准库行为、避开手写解析陷阱，就能在Go项目中轻松应对大多数列表型参数场景。