在Golang中解析HTTP请求需使用*http.Request对象，首先通过r.Header.Get获取请求头，再用r.URL.Query()处理URL参数，接着调用r.ParseForm()解析表单数据并从r.Form或r.PostForm读取，最后通过json.NewDecoder(r.Body).Decode(&struct)处理JSON等结构化请求体。
在Golang中处理HTTP请求，解析请求头和参数是日常开发的基础。核心在于利用
*http.Request对象提供的丰富字段和方法。请求头主要通过
r.Header字段访问，它是一个
map[string][]string类型，Go会将其键名规范化。对于URL查询参数，
r.URL.Query()方法能方便地返回一个
url.Values类型，方便按键获取。而对于POST或PUT请求体中的表单数据，通常需要先调用
r.ParseForm()，然后通过
r.Form（包含URL查询和请求体表单）或
r.PostForm（仅请求体表单）字段来获取。至于JSON、XML等结构化请求体，则需要配合
encoding/json或
encoding/xml等库，使用相应的解码器来处理
r.Body。
解决方案
在Golang的HTTP处理函数中，我们与请求的交互主要围绕
*http.Request对象展开。解析请求头和各种参数是理解客户端意图的关键一步。
1. 解析HTTP请求头 (Headers)
r.Header是一个
http.Header类型，本质上是
map[string][]string。Golang会自动将请求头键名进行规范化处理（例如，
content-type会变为
content-type）。
立即学习“go语言免费学习笔记（深入）”；
-
获取单个值： 使用
r.Header.Get("Header-Name")方法是推荐的做法，它会返回第一个匹配的值，如果不存在则返回空字符串。 -
获取所有值： 直接访问
r.Header["Header-Name"]
会返回一个字符串切片[]string
。
package main
import (
"fmt"
"net/http"
)
func headerHandler(w http.ResponseWriter, r *http.Request) {
// 获取User-Agent头
userAgent := r.Header.Get("User-Agent")
fmt.Fprintf(w, "User-Agent: %s\n", userAgent)
// 获取Accept头的所有值
acceptHeaders := r.Header["Accept"]
fmt.Fprintf(w, "Accept Headers: %v\n", acceptHeaders)
// 尝试获取一个可能不存在的头
nonExistentHeader := r.Header.Get("X-Custom-Header")
if nonExistentHeader == "" {
fmt.Fprintf(w, "X-Custom-Header is not present.\n")
} else {
fmt.Fprintf(w, "X-Custom-Header: %s\n", nonExistentHeader)
}
}
// func main() {
// http.HandleFunc("/headers", headerHandler)
// fmt.Println("Server listening on :8080")
// http.ListenAndServe(":8080", nil)
// }2. 解析URL查询参数 (Query Parameters)
对于GET请求，参数通常附加在URL的查询字符串中（例如
/path?id=123&name=test）。
r.URL.Query()
方法会返回一个url.Values
类型（也是map[string][]string
的别名）。- 使用
q.Get("key")获取第一个值。 - 使用
q["key"]
获取所有值。
package main
import (
"fmt"
"net/http"
)
func queryHandler(w http.ResponseWriter, r *http.Request) {
queryValues := r.URL.Query()
id := queryValues.Get("id")
name := queryValues.Get("name")
tags := queryValues["tag"] // 获取所有名为"tag"的参数
fmt.Fprintf(w, "ID: %s\n", id)
fmt.Fprintf(w, "Name: %s\n", name)
fmt.Fprintf(w, "Tags: %v\n", tags) // 如果URL是 /query?tag=go&tag=web
}
// func main() {
// http.HandleFunc("/query", queryHandler)
// fmt.Println("Server listening on :8080")
// http.ListenAndServe(":8080", nil)
// }3. 解析表单参数 (Form Parameters)
对于POST、PUT等请求，表单数据通常放在请求体中，
content-type通常是
application/x-www-form-urlencoded或
multipart/form-data。
-
关键一步：
r.ParseForm()
在访问表单数据之前，必须先调用r.ParseForm()
来解析请求体。如果请求体类型是multipart/form-data
（例如文件上传），则需要调用r.ParseMultipartForm(maxMemory)
。 -
r.Form
： 包含URL查询参数和请求体中的表单参数。 -
r.PostForm
： 仅包含请求体中的表单参数。 -
快捷方法：
r.FormValue("key")和r.PostFormValue("key")这两个方法会在内部自动调用r.ParseForm()
（如果尚未调用），并返回第一个匹配的参数值。r.FormValue
会检查URL查询参数和请求体参数，而r.PostFormValue
只检查请求体参数。
package main
import (
"fmt"
"net/http"
)
func formHandler(w http.ResponseWriter, r *http.Request) {
if r.Method != http.MethodPost {
http.Error(w, "Only POST method is allowed", http.StatusMethodNotAllowed)
return
}
// 必须先调用ParseForm()
err := r.ParseForm()
if err != nil {
http.Error(w, fmt.Sprintf("Error parsing form: %v", err), http.StatusBadRequest)
return
}
// 从r.Form获取（包含URL查询参数和POST表单参数）
username := r.Form.Get("username")
password := r.Form.Get("password")
// 从r.PostForm获取（仅POST表单参数）
email := r.PostForm.Get("email")
// 使用FormValue快捷方法
age := r.FormValue("age") // 即使没ParseForm也会自动调用
fmt.Fprintf(w, "Username: %s\n", username)
fmt.Fprintf(w, "Password: %s\n", password)
fmt.Fprintf(w, "Email: %s\n", email)
fmt.Fprintf(w, "Age: %s\n", age)
}
// func main() {
// http.HandleFunc("/form", formHandler)
// fmt.Println("Server listening on :8080")
// http.ListenAndServe(":8080", nil)
// }4. 解析JSON/XML请求体 (Request Body)
当
content-type是
application/json或
application/xml时，请求体是结构化的数据。
-
r.Body
： 这是一个io.ReadCloser
接口，代表请求体的数据流。 -
重要：
r.Body
只能被读取一次。读取完毕后，必须关闭它：defer r.Body.Close()
。 -
JSON解析： 使用
json.NewDecoder(r.Body).Decode(&yourStruct)
。 -
XML解析： 使用
xml.NewDecoder(r.Body).Decode(&yourStruct)
。
package main
import (
"encoding/json"
"fmt"
"net/http"
"io/ioutil" // 用于读取原始请求体
)
type User struct {
ID int `json:"id"`
Name string `json:"name"`
Email string `json:"email,omitempty"` // omitempty表示如果为空则不序列化
}
func jsonHandler(w http.ResponseWriter, r *http.Request) {
if r.Method != http.MethodPost {
http.Error(w, "Only POST method is allowed", http.StatusMethodNotAllowed)
return
}
// 确保关闭请求体
defer r.Body.Close()
// 检查Content-Type
if r.Header.Get("Content-Type") != "application/json" {
http.Error(w, "Content-Type must be application/json", http.StatusUnsupportedMediaType)
return
}
var user User
err := json.NewDecoder(r.Body).Decode(&user)
if err != nil {
http.Error(w, fmt.Sprintf 
