Golang构建REST接口：JSON请求响应处理

本文深入浅出地讲解了如何使用原生 Go（net/http 包）构建健壮、清晰的 RESTful JSON 接口，无需依赖第三方框架——从带 json 标签的导出结构体定义、安全可靠的请求体解析（含错误处理与 Content-Type 校验），到规范的 JSON 响应生成（含状态码设置与响应头配置），再到实用的工具函数封装提升代码复用性与可维护性，全面覆盖开发中易忽略却至关重要的细节，助你写出生产就绪的 Go API。

用 Go 构建 RESTful 接口处理 JSON 很直接，核心是 net/http 包配合结构体序列化，无需额外框架也能写出清晰、健壮的 API。

定义结构体映射 JSON 数据

Go 通过结构体字段标签（如 json:"name"）控制 JSON 的序列化与反序列化。注意大小写：只有首字母大写的字段才能被外部包访问，否则 json.Marshal 会忽略它。

例如接收用户注册请求：

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

响应时可定义独立结构体，避免暴露敏感字段或内部实现：

type UserResponse struct {
    ID    int    `json:"id"`
    Name  string `json:"name"`
    Email string `json:"email"`
}

解析 JSON 请求体

在 HTTP 处理函数中，调用 json.NewDecoder(r.Body).Decode(&v) 将请求体解码为结构体。务必检查错误，并提前设置请求头 Content-Type: application/json，否则解码可能静默失败。

常见做法：

• 先检查 r.Method 是否为 POST 或 PUT
• 用 r.Header.Get("Content-Type") 粗略校验（可选）
• 调用 json.Decode，出错时返回 400 Bad Request
• 记得 defer r.Body.Close()（虽然 Decode 读完会自动关闭，但显式写上更稳妥）

生成 JSON 响应

用 json.NewEncoder(w).Encode(v) 直接写入响应体，比 json.Marshal + w.Write 更简洁且自动处理流式编码。别忘了设置响应头：

w.Header().Set("Content-Type", "application/json; charset=utf-8")

成功时常用 200 OK 或 201 Created；出错时设对应状态码，比如：

• w.WriteHeader(http.StatusBadRequest) —— 参数无效
• w.WriteHeader(http.StatusNotFound) —— 资源不存在
• w.WriteHeader(http.StatusInternalServerError) —— 服务端错误

封装基础工具函数提升复用性

重复写 json.Decode/Encode 和状态码逻辑容易出错。可以封装两个小函数：

func parseJSON(r *http.Request, v interface{}) error {
    return json.NewDecoder(r.Body).Decode(v)
}

func writeJSON(w http.ResponseWriter, status int, v interface{}) {
    w.Header().Set("Content-Type", "application/json; charset=utf-8")
    w.WriteHeader(status)
    json.NewEncoder(w).Encode(v)
}

使用时就变成：

var req UserRequest
if err := parseJSON(r, &req); err != nil {
    writeJSON(w, http.StatusBadRequest, map[string]string{"error": "invalid JSON"})
    return
}
writeJSON(w, http.StatusOK, UserResponse{ID: 123, Name: req.Name, Email: req.Email})

不复杂但容易忽略细节，把结构体、解码、响应头、状态码这四点理清楚，RESTful JSON 接口就稳了。

本篇关于《Golang构建REST接口：JSON请求响应处理》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于Golang的相关知识，请关注golang学习网公众号！