Go 的 net/url 包原生支持通过重复键名（如 rgba1=0&rgba1=250）将多个值解析为字符串切片，无需 JSON 或方括号语法；服务端可直接用 r.URL.Query()["rgba1"] 获取字符串数组，再逐个解析为整数。
go 的 `net/url` 包原生支持通过重复键名（如 `rgba1=0&rgba1=250`）将多个值解析为字符串切片，无需 json 或方括号语法；服务端可直接用 `r.url.query()["rgba1"]` 获取字符串数组，再逐个解析为整数。
在构建地理空间瓦片（tile）处理服务时，随着需替换的颜色数量增加，传统单值参数（如 replaceR=0&replaceG=127）会导致 URL 膨胀、可维护性下降。幸运的是，HTTP GET 请求本身不禁止“数组语义”——关键在于利用查询参数的多值特性，而非尝试在 URL 中嵌入 JSON 或自定义格式（如 [0,250,0,230]），后者不仅不符合 URL 编码规范，还易引发解析错误。
✅ 正确做法：使用重复键名
将颜色 RGBA 元组按顺序展开为多个同名参数。例如，要传递两组 4 通道颜色 [0,250,0,230] 和 [0,127,0,0]，构造 URL 如下：
http://localhost:8002/tiles?url=https://example.com/tile.png&rgba1=0&rgba1=250&rgba1=0&rgba1=230&rgba1=0&rgba1=127&rgba1=0&rgba1=0
服务端解析时，r.URL.Query()["rgba1"] 将返回一个 []string，如 ["0", "250", "0", "230", "0", "127", "0", "0"]。你可安全地将其转换为 []uint8：
func parseRGBAArray(vals []string) ([]uint8, error) {
result := make([]uint8, 0, len(vals))
for _, s := range vals {
i, err := strconv.ParseUint(s, 10, 8)
if err != nil {
return nil, fmt.Errorf("invalid uint8 value %q: %w", s, err)
}
result = append(result, uint8(i))
}
return result, nil
}
// 在 handler 中使用：
queries := r.URL.Query()
if rgbaVals, ok := queries["rgba1"]; ok && len(rgbaVals) > 0 {
rgbaBytes, err := parseRGBAArray(rgbaVals)
if err != nil {
http.Error(w, "Invalid rgba1 parameter", http.StatusBadRequest)
return
}
// rgbaBytes 现在是 []uint8，长度应为 4 的倍数（每 4 个元素为一组 RGBA）
for i := 0; i <p>⚠️ 注意事项： </p>
- 不要手动拼接方括号或 JSON：URL 查询参数值必须是合法的 application/x-www-form-urlencoded 字符串，[ 和 ] 需编码为 [/]，且 Go 的 url.Values 不会自动解析其内部结构。
- 避免空值陷阱：若某参数未提供，queries["key"] 返回空切片（非 nil），但 len(queries["key"]) == 0；务必检查长度再解析。
- 长度校验与分组：RGBA 数据应为 4 的倍数，建议在解析后验证 len(rgbaBytes)%4 == 0，否则视为客户端错误。
- 扩展性建议：若颜色组数较多，可引入索引前缀（如 rgba_0_r=0&rgba_0_g=250&...&rgba_1_r=250&...）提升可读性，但重复键方案更简洁通用。
总结：Go 的 net/url.Values 天然支持多值参数，这是传递动态数组最标准、最可靠的方式。放弃自定义序列化，拥抱 HTTP 规范，既能简化客户端构造逻辑，又能确保服务端解析健壮、高效。
