Go语言的net/http包提供了一些列用于表示HTTP报文的解构。我们可以使用它处理请求和发送响应。其中request结构体代表了客户端发生的请求报文。
核心字段获取方法
1. 请求行信息
通过 http.Request
结构体获取:
Go
func handler(w http.ResponseWriter, r *http.Request) {
// 请求方法(GET/POST等)
fmt.Println("Method:", r.Method)
// 完整URL
fmt.Println("URL:", r.URL.String())
urlPath := r.URL.Path // 请求路径(如 "/api/data")
fmt.Println("请求路径:",urlPath)
//直接获取原始查询字符串
rawQuery := r.URL.RawQuery
fmt.Fprintf(w, "Raw Query: %s", rawQuery)
// 方法2:直接获取已解析的 Values(推荐)
values := r.URL.Query()
//url.Values 类型:本质是 map[string][]string,支持多值参数(如 ?tags=go&tags=web)
tags := values["tags"] // 返回字符串切片 []string{"go", "web"}
fmt.Println("查询字符串tags:", tags )
q := values.Get("q") // 返回第一个值,若不存在则返回空字符串
fmt.Println("查询字符串q:", q)
if page, ok := values["page"]; ok {
// 参数存在
fmt.Println("page参数存在:", page)
}else{
fmt.Println("page参数不存在,需要给出默认值:", page)
}
// 协议版本
fmt.Println("Protocol:", r.Proto)
}
RawQuery
中的参数是 已编码 的(如空格为 %20
),需使用 url.QueryUnescape
解码:
decoded, _ := url.QueryUnescape(r.URL.RawQuery)
频繁操作查询参数时,优先使用 r.URL.Query()
缓存解析结果,避免重复解析。
2. 请求头信息
使用 Header
字段读取:
规范化的头字段名
Go 会自动将头字段名规范化(首字母大写),例如:
user-agent
→User-Agent
content-type
→Content-Type
Go
//1. 获取单个头信息值
//Get() 方法:返回指定键的第一个值(适用于单值头字段)。
encoding := r.Header.Get("Accept-Encoding") // 返回 "gzip"
//直接访问 map:获取值的切片(需处理空值情况)。
if values := r.Header["User-Agent"]; len(values) > 0 {{
userAgent = values[0]
}}
// 获取多值头信息
//Values() 方法(Go 1.14+):返回所有值的切片。
encodings := r.Header.Values("Accept-Encoding") // ["gzip", "deflate"]
// 遍历所有头部
for key, values := range r.Header {
fmt.Printf("%s: %v\n", key, values)
}
3. 查询参数(URL 参数)
手动解析 URL 中的 Query
参数:
Go
// 方法:手动解析(需处理错误)
decoded, _ := url.QueryUnescape(r.URL.RawQuery)
values, err := url.ParseQuery(decoded)
if err != nil {
http.Error(w, "Invalid query", http.StatusBadRequest)
return
}
4. 请求体内容
根据 Content-Type
处理不同格式的请求体:
Go
// 读取全部内容(适用于小数据)
body, err := ioutil.ReadAll(r.Body)
if err != nil {
http.Error(w, "Read body failed", http.StatusBadRequest)
return
}
fmt.Println("Body:", string(body))
// 关闭Body(必须)
defer r.Body.Close()
a. 表单数据(Form Data)
Go
err := r.ParseForm() // 显式解析表单
username := r.FormValue("username") // 获取单个字段(也可以获取url传递过来的参数)
allFormData := r.PostForm // 获取全部表单数据(map类型,不含url传递过来的参数)
allFormData2 := r.Form // 获取全部表单数据(map类型,包含url传递过来的参数)

FormValue会隐式调用解析。
例子:
html
<div class="login-container">
<h2>系统登录</h2>
<form action="/api?username=lisi&pwd=wangwu" method="post">
<div class="form-group">
<label>用户名:</label>
<input type="text" name="uname" value="赵六" required>
</div>
<div class="form-group">
<label>密码:</label>
<input type="password" name="pwd" value="123" required>
</div>
<button class="btn-login" type="submit">登录</button>
</form>
</div>
html
func apiHandler(w http.ResponseWriter, r *http.Request) {
username1 := r.FormValue("username")
uname1 := r.FormValue("uname")
pwd1 := r.FormValue("pwd")
allFormData := r.PostForm
username2 := allFormData["username"]
uname2 := allFormData["uname"]
pwd2 := allFormData["pwd"]
allData := r.Form
username3 := r.Form["username"]
uname3 := r.Form["uname"]
pwd3 := r.Form["pwd"]
fmt.Println("FormValue方法:", username1, uname1)
fmt.Println("FormValue方法:", pwd1)
fmt.Println("==========")
fmt.Println("PostForm:", allFormData)
fmt.Println("PostForm:", username2, uname2)
fmt.Println("PostForm:", pwd2)
fmt.Println("==========")
fmt.Println("allData:", allData)
fmt.Println("allData:", username3, uname3)
fmt.Println("allData:", pwd3)
}
b. JSON 数据
Go
body, _ := io.ReadAll(r.Body) // 读取原始Body
var data map[string]interface{}
json.Unmarshal(body, &data) // 反序列化到结构体
c. 文件上传(Multipart)
Go
package main
import (
"fmt"
"io/ioutil"
"net/http"
)
func uploadHandler(w http.ResponseWriter, r *http.Request) {
// 限制请求体大小(防大文件攻击)
r.ParseMultipartForm(10 << 20) // 10MB
// 获取普通表单字段
title := r.FormValue("title")
// 处理文件上传
file, _, err := r.FormFile("file")
if err != nil {
http.Error(w, "文件上传失败", http.StatusBadRequest)
return
}
defer file.Close()
// 保存文件
data, _ := ioutil.ReadAll(file)
ioutil.WriteFile("/uploads/"+title, data, 0644)
fmt.Fprintln(w, "上传成功")
}
func main() {
http.HandleFunc("/upload", uploadHandler)
http.ListenAndServe(":8080", nil)
}