Go通过encoding/json包实现JSON解析与生成，使用struct tag映射字段，支持动态解析为map[string]interface{}，结合net/http构建RESTful接口，需注重错误处理、输入验证及中间件应用。
在现代 Web 开发中，Go（Golang）凭借其简洁的语法、高效的并发支持和出色的性能，成为构建高性能 API 接口服务的热门选择。处理 JSON 数据是接口开发中的核心任务之一，本文将带你快速掌握 Golang 中如何解析 JSON 数据并开发 RESTful 接口。
JSON 解析基础
Go 通过 encoding/json 包提供对 JSON 的编码与解码支持。使用 json.Unmarshal 和 json.Marshal 可实现结构体与 JSON 字符串之间的转换。
定义结构体时，可通过标签（tag）指定字段对应的 JSON 键名：
type User struct {
ID int `json:"id"`
Name string `json:"name"`
Email string `json:"email,omitempty"` // omitempty 表示空值不输出
}
解析 JSON 字符串示例：
立即学习“go语言免费学习笔记（深入）”；
jsonData := `{"id": 1, "name": "Alice", "email": "alice@example.com"}`
var user User
err := json.Unmarshal([]byte(jsonData), &user)
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", user)
处理动态或未知结构的 JSON
当 JSON 结构不确定时，可使用 map[string]interface{} 或 interface{} 进行解析。
例如解析一个通用请求体：
本文档主要讲述的是用Apache Spark进行大数据处理——第一部分：入门介绍；Apache Spark是一个围绕速度、易用性和复杂分析构建的大数据处理框架。最初在2009年由加州大学伯克利分校的AMPLab开发，并于2010年成为Apache的开源项目之一。 在这个Apache Spark文章系列的第一部分中，我们将了解到什么是Spark，它与典型的MapReduce解决方案的比较以及它如何为大数据处理提供了一套完整的工具。希望本文档会给有需要的朋友带来帮助；感
var data map[string]interface{}
err := json.Unmarshal([]byte(jsonStr), &data)
if err != nil {
log.Fatal(err)
}
fmt.Println(data["name"])
注意：访问嵌套字段时需进行类型断言，避免 panic。
构建 RESTful 接口
使用 Go 标准库 net/http 即可快速搭建 HTTP 服务。
示例：实现一个接收 JSON 并返回响应的 POST 接口：
func createUser(w http.ResponseWriter, r *http.Request) {
if r.Method != "POST" {
http.Error(w, "仅支持 POST 请求", http.StatusMethodNotAllowed)
return
}
var user User
decoder := json.NewDecoder(r.Body)
defer r.Body.Close()
if err := decoder.Decode(&user); err != nil {
http.Error(w, "JSON 解析失败", http.StatusBadRequest)
return
}
// 模拟保存逻辑
user.ID = 1001
w.Header().Set("Content-Type", "application/json")
json.NewEncoder(w).Encode(user)
}
func main() {
http.HandleFunc("/user", createUser)
fmt.Println("服务启动在 :8080")
log.Fatal(http.ListenAndServe(":8080", nil))
}
错误处理与最佳实践
实际项目中需关注以下几点：
- 始终检查 JSON 解码错误，返回合适的 HTTP 状态码
- 使用中间件统一处理日志、CORS、认证等横切关注点
- 对敏感字段如密码，使用 json:"-" 忽略序列化
- 考虑使用第三方框架如 gin 或 echo 提升开发效率
- 验证输入数据合法性，避免注入或越界问题
基本上就这些。掌握 JSON 解析和基本路由处理后，你已经具备用 Go 构建轻量级 API 的能力。后续可扩展数据库集成、JWT 认证、Swagger 文档等功能，逐步完善项目结构。
