Golang处理HTTP请求体与响应体教程

来到golang学习网的大家，相信都是编程学习爱好者，希望在这里学习Golang相关编程知识。下面本篇文章就来带大家聊聊《Golang处理HTTP请求体与响应体详解》，介绍一下，希望对大家的知识积累有所帮助，助力实战开发！

Go语言通过net/http库处理HTTP请求和响应体，服务端使用r.Body读取请求数据并及时关闭，可结合io.ReadAll或json.NewDecoder解析JSON；客户端则用http.Client发送带体的请求，需设置Content-Type头并编码数据；响应时通过w.WriteHeader和json.NewEncoder返回结果，注意资源释放与错误处理。

Go语言处理HTTP请求体和响应体非常直观，主要依赖标准库net/http。无论是构建Web服务端接收客户端数据，还是作为HTTP客户端调用外部接口，都需要正确读取请求体和写入响应体。下面介绍常见操作方式和注意事项。

读取HTTP请求体（Server端）

在服务端处理请求时，请求体数据通常通过r.Body获取，它是一个io.ReadCloser。需要手动读取并关闭。

常见做法：

• 使用ioutil.ReadAll一次性读取整个请求体（适用于小数据）
• 对JSON数据，通常配合json.NewDecoder反序列化
• 记得调用Body.Close()避免资源泄露

func handler(w http.ResponseWriter, r *http.Request) {
    defer r.Body.Close()
    
    body, err := io.ReadAll(r.Body)
    if err != nil {
        http.Error(w, "无法读取请求体", http.StatusBadRequest)
        return
    }

    // 处理 body 数据
    fmt.Fprintf(w, "收到数据: %s", string(body))
}

解析JSON请求体

大多数API使用JSON格式传输数据。Go可以通过结构体绑定简化处理。

步骤：

• 定义结构体字段并添加json:标签
• 使用json.NewDecoder(r.Body).Decode(&struct)解析
• 检查解码错误，如格式不合法或字段缺失

type User struct {
    Name string `json:"name"`
    Age  int    `json:"age"`
}

func createUser(w http.ResponseWriter, r *http.Request) {
    var user User
    if err := json.NewDecoder(r.Body).Decode(&user); err != nil {
        http.Error(w, "JSON格式错误", http.StatusBadRequest)
        return
    }
    fmt.Fprintf(w, "创建用户: %s, 年龄: %d", user.Name, user.Age)
}

发送响应体（Response Write）

响应体通过http.ResponseWriter写入，可以是字符串、JSON或其他格式。

关键点：

• 设置正确的Content-Type头，如w.Header().Set("Content-Type", "application/json")
• 使用json.NewEncoder方便输出JSON
• 状态码可通过w.WriteHeader()指定

func getUser(w http.ResponseWriter, r *http.Request) {
    user := map[string]interface{}{
        "id":   1,
        "name": "Alice",
    }

    w.Header().Set("Content-Type", "application/json")
    w.WriteHeader(http.StatusOK)
    json.NewEncoder(w).Encode(user)
}

作为HTTP客户端发送请求体

使用http.Client发起POST/PUT等带请求体的请求。

常用方法：

• 将JSON数据编码为字节流，用bytes.NewReader包装成io.Reader
• 设置请求头Content-Type
• 手动调用resp.Body.Close()

data := map[string]string{"name": "Bob"}
body, _ := json.Marshal(data)

req, _ := http.NewRequest("POST", "https://api.example.com/users", bytes.NewReader(body))
req.Header.Set("Content-Type", "application/json")

client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
    log.Fatal(err)
}
defer resp.Body.Close()

// 读取响应
result, _ := io.ReadAll(resp.Body)
fmt.Println(string(result))

基本上就这些。Golang的HTTP处理机制简洁高效，只要掌握Body的读写方式、JSON编解码和Header设置，就能应对大多数场景。注意资源释放和错误处理，避免内存泄漏或静默失败。

终于介绍完啦！小伙伴们，这篇关于《Golang处理HTTP请求体与响应体教程》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布Golang相关知识，快来关注吧！