17370845950

本文详解如何使用 go 标准库 `encoding/json` 解析 url 查询参数（如 `filters`）中合法的 json 字符串，并处理常见错误（如非法 json、空值、类型不匹配），附完整可运行示例。

在 Go Web 开发中，常需从 HTTP 请求的查询字符串中提取结构化数据（如过滤条件）。但需特别注意：URL 查询参数本身不是自动解析的 JSON——它只是普通字符串，且必须符合 JSON 语法规范才能被 json.Unmarshal 正确解析。

例如，原始问题中的 URL：

http://127.0.0.1:3001/find?field=hostname&field=App&filters=["hostname":"example.com,"type":"vm"]

该 filters 值存在两个严重问题：

• 使用了方括号 []，但内部是键值对（非 JSON 数组格式）；
• 缺少双引号包裹键名（hostname 应为 "hostname"），且值内引号未转义，导致 JSON 无效。

✅ 正确的 URL 应将 filters 设为标准 JSON 对象字符串：

...&filters={"hostname":"example.com","type":"vm"}

✅ 正确解析步骤（含错误处理）

以下是在 http.HandlerFunc 中安全解析 filters 参数的推荐写法：

func handleFind(w http.ResponseWriter, r *http.Request) {
    // 1. 获取 filters 查询参数值（注意：Get() 返回单个字符串，避免索引越界）
    filtersStr := r.URL.Query().Get("filters")
    if filtersStr == "" {
        http.Error(w, "missing 'filters' parameter", http.StatusBadRequest)
        return
    }

    // 2. 定义目标结构体（比 map[string]string 更类型安全、可扩展）
    var filters struct {
        Hostname string `json:"hostname"`
        Type     string `json:"type"`
        // 可按需添加其他字段，如 Status, Region 等
    }

    // 3. 解析 JSON 字符串
    if err := json.Unmarshal([]byte(filtersStr), &filters); err != nil {
        http.Error(w, "invalid JSON in 'filters': "+err.Error(), http.StatusBadRequest)
        return
    }

    // 4. 使用解析结果
    fmt.Printf("Hostname: %s, Type: %s\n", filters.Hostname, filters.Type)
    // 输出：Hostname: example.com, Type: vm
}

⚠️ 关键注意事项

• 永远优先使用 r.URL.Query().Get("key") 而非 r.URL.Query()["key"][0]：前者在键不存在时返回空字符串，后者可能 panic（切片越界）；
• 避免裸用 map[string]string：虽简单，但无法校验字段是否存在、类型是否匹配；结构体 + struct tag 是更健壮的选择；
• URL 编码很重要：若 JSON 值含特殊字符（如空格、引号），必须在客户端 encodeURIComponent()（JS）或服务端 url.PathEscape() 处理，否则解析会失败；
• 不要信任客户端输入：始终验证解析结果（如检查 filters.Hostname != ""），并返回明确的 HTTP 错误状态码。

✅ 总结

解析 URL 中的 JSON 参数 = 正确构造（服务端/客户端） + 安全获取（Query().Get） + 类型化解码（json.Unmarshal） + 全面错误处理。跳过任一环节都可能导致 panic、静默失败或安全漏洞。坚持使用结构体定义 schema，是写出可维护 Go Web API 的关键实践。