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

在Go语言的后端开发中，前端有时会将复杂的查询条件、配置信息等内容序列化为JSON字符串，然后作为URL的查询参数传递给后端接口。这时候后端就需要正确获取并解析这个JSON字符串，才能得到对应的结构化数据。

基础解析流程

首先要从URL查询参数中获取到对应的值，Go标准库的net/url包提供了处理URL的相关能力，我们可以通过url.Parse或者直接获取请求的查询参数集合来得到目标值。

第一步：获取查询参数值

如果是处理HTTP请求，可以直接从*http.Request的URL.Query()方法中获取参数，示例代码如下：

package main

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

// 定义接收JSON参数的结构体
type QueryParam struct {
	Name  string `json:"name"`
	Age   int    `json:"age"`
	Tags  []string `json:"tags"`
}

func handler(w http.ResponseWriter, r *http.Request) {
	// 获取查询参数中的json_param字段值
	jsonStr := r.URL.Query().Get("json_param")
	if jsonStr == "" {
		fmt.Fprintf(w, "json_param参数不存在")
		return
	}
	fmt.Printf("获取到的原始参数值: %sn", jsonStr)
}

第二步：URL解码处理

URL中的查询参数会对特殊字符进行编码，比如JSON中的双引号、花括号等都会被编码为%XX的形式，所以我们需要先对获取到的字符串进行URL解码，否则直接解析JSON会失败。

使用url.QueryUnescape方法可以完成解码操作：

func handler(w http.ResponseWriter, r *http.Request) {
	jsonStr := r.URL.Query().Get("json_param")
	if jsonStr == "" {
		fmt.Fprintf(w, "json_param参数不存在")
		return
	}
	// URL解码
	decodedStr, err := url.QueryUnescape(jsonStr)
	if err != nil {
		fmt.Fprintf(w, "参数解码失败: %v", err)
		return
	}
	fmt.Printf("解码后的字符串: %sn", decodedStr)
}

第三步：JSON反序列化

解码完成后，就可以使用encoding/json包的反序列化方法将字符串转换为对应的结构体实例：

func handler(w http.ResponseWriter, r *http.Request) {
	jsonStr := r.URL.Query().Get("json_param")
	if jsonStr == "" {
		fmt.Fprintf(w, "json_param参数不存在")
		return
	}
	decodedStr, err := url.QueryUnescape(jsonStr)
	if err != nil {
		fmt.Fprintf(w, "参数解码失败: %v", err)
		return
	}
	var param QueryParam
	err = json.Unmarshal([]byte(decodedStr), &param)
	if err != nil {
		fmt.Fprintf(w, "JSON解析失败: %v", err)
		return
	}
	fmt.Fprintf(w, "解析结果: name=%s, age=%d, tags=%v", param.Name, param.Age, param.Tags)
}

func main() {
	http.HandleFunc("/query", handler)
	http.ListenAndServe(":8080", nil)
}

常见问题与解决方案

问题1：参数值包含特殊字符导致解码失败

如果前端传递的JSON字符串没有正确进行URL编码，或者编码过程不完整，会导致QueryUnescape返回错误。这时候需要前端确保传递参数前对JSON字符串做完整的URL编码，比如使用JavaScript的encodeURIComponent方法处理后再拼接参数。

问题2：JSON格式不符合预期

可以在反序列化前先校验字符串是否为合法的JSON格式，比如检查字符串是否以{开头、以}结尾，或者先尝试解析到interface{}类型判断结构是否符合要求。

问题3：结构体字段映射错误

确保结构体的字段标签和JSON中的键名一致，且字段是可导出的（首字母大写），否则JSON反序列化时无法给对应字段赋值。

完整示例验证

我们可以启动服务后，用以下请求验证效果：

# 前端传递的json_param值是 {"name":"张三","age":20,"tags":["go","编程"]} 经过encodeURIComponent编码后的结果
curl "http://127.0.0.1:8080/query?json_param=%7B%22name%22%3A%22%E5%BC%A0%E4%B8%89%22%2C%22age%22%3A20%2C%22tags%22%3A%5B%22go%22%2C%22%E7%BC%96%E7%A8%8B%22%5D%7D"

请求后会返回解析后的结果，说明整个流程是正确可用的。

GoURL_query_parseJSON_string_decodenet_url修改时间：2026-06-18 11:57:18