GolangHTTP请求头与参数解析实践-Golang-PHP中文网

GolangHTTP请求头与参数解析实践

P粉602998670

发布： 2025-09-14 13:54:02

原创

932人浏览过

在Golang中解析HTTP请求需使用*http.Request对象，首先通过r.Header.Get获取请求头，再用r.URL.Query()处理URL参数，接着调用r.ParseForm()解析表单数据并从r.Form或r.PostForm读取，最后通过json.NewDecoder(r.Body).Decode(&struct)处理JSON等结构化请求体。

golanghttp请求头与参数解析实践

在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)

来画数字人直播

来画数字人自动化直播，无需请真人主播，即可实现24小时直播，无缝衔接各大直播平台。

查看详情

对于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

登录后复制

以上就是GolangHTTP请求头与参数解析实践的详细内容，更多请关注php中文网其它相关文章！