Go语言中解析HTTP请求参数需根据请求方法和数据格式选择合适方式：1. GET请求使用FormValue或ParseForm解析URL查询参数；2. POST表单数据通过ParseForm处理application/x-www-form-urlencoded格式；3. JSON请求体利用json.Decoder解码，需校验Content-Type并关闭Body；4. 文件上传采用ParseMultipartForm解析multipart/form-data，设置内存限制并通过FormFile获取文件。正确选择解析方法并处理错误是关键。
在Go语言中处理HTTP请求时，解析请求参数是开发Web服务的基础操作。不同的请求方法（如GET、POST）和数据格式（如表单、JSON）需要采用不同的解析方式。本文将介绍如何正确解析各类HTTP请求参数，并提供实用代码示例。
解析URL查询参数（GET请求）
对于GET请求，参数通常附加在URL的查询字符串中。Go的*http.Request对象提供了FormValue和ParseForm方法来获取这些参数。
推荐使用FormValue，它会自动解析查询字符串并返回指定键的值：
func handler(w http.ResponseWriter, r *http.Request) {
name := r.FormValue("name")
age := r.FormValue("age")
fmt.Fprintf(w, "Name: %s, Age: %s", name, age)
}
如果需要访问多个同名参数或手动控制解析过程，可调用r.ParseForm()后直接读取r.Form map：
立即学习“go语言免费学习笔记（深入）”；
err := r.ParseForm()
if err != nil {
http.Error(w, "无法解析表单", http.StatusBadRequest)
return
}
names := r.Form["name"] // 返回字符串切片
处理表单提交（POST表单数据）
当客户端通过POST提交表单（application/x-www-form-urlencoded）时，同样可以使用FormValue或ParseForm。
注意：必须确保在读取Body前未被其他操作消耗。以下是一个完整示例：
func postHandler(w http.ResponseWriter, r *http.Request) {
if r.Method != "POST" {
http.Error(w, "仅支持POST方法", http.StatusMethodNotAllowed)
return
}
err := r.ParseForm()
if err != nil {
http.Error(w, "解析表单失败", http.StatusBadRequest)
return
}
username := r.FormValue("username")
password := r.FormValue("password")
fmt.Fprintf(w, "用户: %s 提交了登录请求", username)
}
解析JSON请求体
现代API常使用JSON格式传输数据。Go标准库encoding/json配合json.Decoder可高效解析请求体。
定义结构体匹配客户端数据结构，然后解码：
type User struct {
Name string `json:"name"`
Email string `json:"email"`
}
func jsonHandler(w http.ResponseWriter, r *http.Request) {
if r.Header.Get("Content-Type") != "application/json" {
http.Error(w, "Content-Type需为application/json", http.StatusUnsupportedMediaType)
return
}
var user User
decoder := json.NewDecoder(r.Body)
err := decoder.Decode(&user)
if err != nil {
http.Error(w, "JSON解析失败", http.StatusBadRequest)
return
}
defer r.Body.Close()
fmt.Fprintf(w, "收到用户: %s, 邮箱: %s", user.Name, user.Email)
}
记得在解码后关闭r.Body以释放资源，尤其是在高并发场景下很重要。
上传文件与多部分表单
对于包含文件上传的表单（multipart/form-data），应使用ParseMultipartForm。
设置内存限制（如32MB），然后通过FormFile获取文件句柄：
func uploadHandler(w http.ResponseWriter, r *http.Request) {
err := r.ParseMultipartForm(32 << 20) // 最大32MB
if err != nil {
http.Error(w, "解析 multipart 失败", http.StatusBadRequest)
return
}
file, handler, err := r.FormFile("uploadfile")
if err != nil {
http.Error(w, "获取文件失败", http.StatusBadRequest)
return
}
defer file.Close()
// 保存文件或处理内容
fmt.Fprintf(w, "上传文件名: %s, 大小: %d", handler.Filename, handler.Size)
}
基本上就这些常见场景的处理方式。掌握这些方法后，就能灵活应对大多数Web请求参数解析需求。关键在于根据Content-Type选择正确的解析路径，并做好错误处理。不复杂但容易忽略细节。
