登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  Golang >  Go教程

Golang发送JSON结构体请求教程

时间：2026-04-13 19:31:10 106浏览 收藏

本文手把手教你如何在Go语言中高效、规范地发送JSON HTTP请求，从定义带json标签的导出结构体开始，到序列化、构造带正确Content-Type头的POST请求，再到发送、错误处理、响应解析及超时控制，全程覆盖实战关键细节；还提供了可复用的封装函数示例，帮你告别重复样板代码，快速集成API调用，是Golang开发者日常开发中不可或缺的实用指南。

如何使用Golang发送JSON请求_HTTP客户端传递结构体数据

用 Go 发送 JSON 请求很简单，核心是把结构体序列化为 JSON，再通过 http.Client 发起 POST（或其他方法）请求，同时设置正确的请求头。

定义结构体并导出字段

Go 的 json.Marshal 只能序列化首字母大写的导出字段。记得加 JSON 标签来控制键名：

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

使用示例：

  • 字段名小写（如 name）不会被序列化 → 必须大写开头（Name）
  • json:"name" 决定最终 JSON 中的字段名，不加标签则默认用结构体字段名
  • 空值处理可用 omitempty，例如 Phone string `json:"phone,omitempty"`

构造请求体并设置 Header

把结构体转成 JSON 字节流，作为请求体，并显式设置 Content-Type: application/json：

user := User{Name: "张三", Email: "zhang@example.com", Age: 28}
jsonData, err := json.Marshal(user)
if err != nil {
    log.Fatal(err)
}

req, err := http.NewRequest("POST", "https://api.example.com/users", bytes.NewBuffer(jsonData))
if err != nil {
log.Fatal(err)
}
req.Header.Set("Content-Type", "application/json")

注意：

  • 别忘了 bytes.NewBuffer(jsonData) 把字节切片包装成 io.Reader
  • Header 必须手动设置，标准库不会自动加 Content-Type
  • 如果需要认证，可追加：req.Header.Set("Authorization", "Bearer xxx")

发送请求并读取响应

用默认或自定义的 http.Client 发送，检查状态码，再解析响应体：

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

if resp.StatusCode < 200 || resp.StatusCode >= 300 {
log.Fatalf("HTTP error: %d", resp.StatusCode)
}
body, _ := io.ReadAll(resp.Body)
var result map[string]interface{}
json.Unmarshal(body, &result)
fmt.Printf("Response: %+v\n", result)

常见做法：

  • 用 io.ReadAll 一次性读完响应体，避免残留
  • 根据 API 返回结构，定义对应响应结构体更安全（比 map[string]interface{} 类型强）
  • 生产环境建议设置超时：&http.Client{Timeout: 10 * time.Second}

封装成可复用函数

把重复逻辑抽出来，提升可读性和复用性：

func PostJSON(url string, payload interface{}) (*http.Response, error) {
    jsonData, err := json.Marshal(payload)
    if err != nil {
        return nil, err
    }
    req, err := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
    if err != nil {
        return nil, err
    }
    req.Header.Set("Content-Type", "application/json")

return &http.Client{Timeout: 5 * time.Second}.Do(req)
}

调用示例：

resp, err := PostJSON("https://api.example.com/users", User{
    Name:  "李四",
    Email: "li@example.com",
    Age:   30,
})
if err != nil {
    log.Fatal(err)
}
defer resp.Body.Close()

这样后续只需关注业务数据，不用每次写样板代码。

到这里，我们也就讲完了《Golang发送JSON结构体请求教程》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！

相关阅读
更多>
最新阅读
更多>
课程推荐
更多>