最直接方式是用http.Post发送固定JSON请求，但需json.Marshal后bytes.NewReader包装；更推荐http.Client+http.NewRequest以精确控制超时、header等。
用 http.Post 发送简单 JSON 请求最直接
如果只是发一个固定结构的 JSON 到某个 API，不需要自定义 header 或复用 client，http.Post 是最快路径。它自动设置 Content-Type: application/json，但注意：它不处理错误响应体，只检查网络层错误。
-
http.Post第三个参数必须是io.Reader，不能直接传 struct；得先用json.Marshal编码成字节切片，再用bytes.NewReader包装 - 返回的
*http.Response需要手动调用resp.Body.Close()，否则会泄漏连接 - 它默认使用全局
http.DefaultClient，不支持超时控制——这点在生产环境容易出问题
data := map[string]string{"name": "alice", "role": "dev"}
payload, _ := json.Marshal(data)
resp, err := http.Post("https://api.example.com/users", "application/json", bytes.NewReader(payload))
if err != nil {
log.Fatal(err)
}
defer resp.Body.Close()
用 http.Client + http.NewRequest 精确控制请求行为
多数真实场景需要设置超时、自定义 header、复用连接或处理 4xx/5xx 响应体，这时必须自己构造 *http.Request 并用 *http.Client 发送。
-
http.NewRequest不会自动设Content-Type，必须显式调用req.Header.Set("Content-Type", "application/json") -
http.Client.Timeout控制整个请求生命周期（DNS + 连接 + 写入 + 读取），不是仅连接超时 - 若需更细粒度控制（比如只限制后端响应时间），得用
context.WithTimeout传给client.Do
client := &http.Client{
Timeout: 10 * time.Second,
}
data := struct{ Name string }{"bob"}
payload, _ := json.Marshal(data)
req, _ := http.NewRequest("POST", "https://api.example.com/users", bytes.NewReader(payload))
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer xyz")
resp, err := client.Do(req)
if err != nil {
log.Fatal(err)
}
defer resp.Body.Close()
接收 JSON 响应时别忘了检查 resp.StatusCode
http.Client.Do 只在网络失败时返回 error，HTTP 状态码如 400 Bad Request 或 502 Bad Gateway 都算“成功响应”，必须手动判断。否则可能把错误响应当正常数据解码，导致 panic 或逻辑错乱。
- 常见误操作：直接对
resp.Body调用json.Decode，却不检查resp.StatusCode - 建议统一处理：状态码非 2xx 时，先读取并记录
resp.Body内容（用于调试），再返回错误 - 注意
resp.Body只能读一次；如果日志里已读过，后续json.Decode会得到空数据
结构体字段导出与 JSON tag 决定序列化结果
Go 的 json.Marshal 只序列化导出字段（首字母大写），且受 json: tag 控制。没加 tag 时默认用字段名小写，但嵌套或命名不一致时极易出错。
立即学习“go语言免费学习笔记（深入）”；
- 字段名含下划线（如
User_id）不会自动转成user_id，必须显式写json:"user_id" - 想忽略空值字段，用
json:",omitempty"；但要注意：零值字符串""、数字0、布尔false都会被跳过 - 私有字段（小写开头）无论有没有 tag，都不会被编码——这不是 bug，是 Go 的反射规则
type User struct {
ID int `json:"id"`
Name string `json:"name"`
Email string `json:"email,omitempty"`
token string `json:"token"` // 这个字段不会出现在 JSON 中
}
真正容易卡住的地方，往往不是怎么发，而是响应状态码没检查、Body 被重复读、或者结构体字段没导出却以为能序列化。
