如何在 Go 中正确解析 URL 查询参数中的 JSON 字符串-Golang-PHP中文网

如何在 Go 中正确解析 URL 查询参数中的 JSON 字符串

本文讲解如何使用 go 的 `encoding/json` 包安全、准确地解析 url 查询参数（如 `filters`）中传递的合法 json 字符串，并提取结构化字段值，同时指出原始 url 中 json 格式错误的问题及修复方法。

在 Go Web 开发中，常需从 HTTP 请求的查询参数中读取结构化数据（如过滤条件）。但需注意：URL 查询参数本身是键值对字符串，不能直接包含未编码的 JSON 对象或数组——尤其当 JSON 中含有引号、冒号、逗号等特殊字符时，会破坏 URL 解析逻辑。

例如，原始 URL：

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

该 filters 值 不是合法 JSON：方括号 [] 表示数组，但内部却写成了对象语法（缺少 {}），且键名未用双引号包裹（"hostname" 缺失引号），逗号后也缺少空格与引号闭合，导致 json.Unmarshal 必然失败。

✅ 正确做法是：

前端设计引擎

使用此技能可创建独具特色、具备生产级质量的前端界面，设计品质高。当用户要求构建网页组件、页面、产物、海报或应用程序时（例如：网站、落地页、仪表盘、React 组件、HTML/CSS 布局，或对任意 Web UI 进行样式优化与视觉美化），请启用该能力。输出需为富有创意、精雕细琢的代码与 UI 设计，避免千篇一律的 AI 风格。

下载

服务端要求客户端发送符合 JSON 规范的字符串（推荐使用对象 {...} 而非数组）；
对 JSON 字符串进行 URL 编码（避免特殊字符干扰 query 解析）；
使用 url.Query().Get("filters") 获取解码后的字符串；
用 json.Unmarshal 解析为 Go 原生类型（如 map[string]string 或自定义 struct）。

✅ 正确示例（服务端解析逻辑）

package main

import (
    "encoding/json"
    "fmt"
    "log"
    "net/http"
    "net/url"
)

func handler(w http.ResponseWriter, r *http.Request) {
    // 1. 获取 filters 参数值（自动完成 URL 解码）
    filtersStr := r.URL.Query().Get("filters")
    if filtersStr == "" {
        http.Error(w, "missing 'filters' parameter", http.StatusBadRequest)
        return
    }

    // 2. 定义目标结构（更推荐：使用 struct 提升类型安全）
    var filters map[string]string
    // 或：var filters struct { Hostname string `json:"hostname"`; Type string `json:"type"` }

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

    // 4. 安全提取字段（避免 panic）
    hostname, ok1 := filters["hostname"]
    typ, ok2 := filters["type"]

    if !ok1 || !ok2 {
        http.Error(w, "required fields 'hostname' and 'type' not found", http.StatusBadRequest)
        return
    }

    fmt.Fprintf(w, "Hostname: %s, Type: %s", hostname, typ)
}

func main() {
    http.HandleFunc("/find", handler)
    log.Println("Server starting on :3001...")
    log.Fatal(http.ListenAndServe(":3001", nil))
}

? 关键注意事项

永远不要信任客户端输入：必须校验 filters 是否为空、JSON 是否合法、必需字段是否存在；
推荐使用结构体而非 map[string]string，可结合 JSON tag 实现字段映射与默认值控制；

客户端应 URL 编码 JSON 字符串，例如：

# 原始 JSON: {"hostname":"example.com","type":"vm"}
# 编码后（curl 示例）：
curl "http://127.0.0.1:3001/find?filters=%7B%22hostname%22%3A%22example.com%22%2C%22type%22%3A%22vm%22%7D"

Go 的 url.Parse() 和 r.URL.Query() 会自动解码，无需手动调用 url.QueryUnescape；