使用json.NewDecoder解析JSON请求体并绑定到结构体,2. 通过json.NewEncoder将数据编码为JSON响应,3. 设置Content-Type头并处理错误,确保服务稳定。

在Go语言中处理JSON请求和响应是构建Web服务的常见需求。Golang标准库
encoding/json提供了强大的支持,结合
net/http包可以轻松实现JSON数据的解析与生成。下面介绍如何在HTTP服务中读取JSON请求体并返回JSON响应。
解析JSON请求体
当客户端发送JSON格式的数据(如POST或PUT请求)时,服务器需要读取请求体并将其反序列化为Go结构体。
步骤如下:
- 使用
json.NewDecoder
从http.Request.Body
读取数据 - 定义与JSON结构匹配的Go结构体
- 调用
Decode()
方法将JSON填充到结构体中
示例代码:
立即学习“go语言免费学习笔记(深入)”;
func handleLogin(w http.ResponseWriter, r *http.Request) {if r.Method != "POST" {
http.Error(w, "只允许POST请求", http.StatusMethodNotAllowed)
return
}
var user struct {
Username string `json:"username"`
Password string `json:"password"`
}
err := json.NewDecoder(r.Body).Decode(&user)
if err != nil {
http.Error(w, "无效的JSON数据", http.StatusBadRequest)
return
}
// 处理登录逻辑
fmt.Printf("用户: %s 尝试登录\n", user.Username)
}
生成JSON响应数据
服务端处理完请求后,通常需要返回JSON格式的响应,比如操作结果、资源数据等。
关键点:
- 设置响应头
Content-Type: application/json
- 使用
json.NewEncoder
将Go数据编码为JSON并写入响应 - 结构体字段需导出(首字母大写),并使用
json
标签控制字段名
示例代码:
立即学习“go语言免费学习笔记(深入)”;
func getUser(w http.ResponseWriter, r *http.Request) {user := struct {
ID int `json:"id"`
Name string `json:"name"`
Email string `json:"email"`
}{
ID: 1,
Name: "张三",
Email: "zhangsan@example.com",
}
w.Header().Set("Content-Type", "application/json")
json.NewEncoder(w).Encode(user)
}
完整HTTP服务示例
将上述功能整合到一个简单的服务中:
package mainimport (
"encoding/json"
"net/http"
)
func main() {
http.HandleFunc("/login", handleLogin)
http.HandleFunc("/user", getUser)
http.ListenAndServe(":8080", nil)
}
启动服务后,可用curl测试:
curl -X POST http://localhost:8080/login \-H "Content-Type: application/json" \
-d '{"username":"alice","password":"123456"}'
基本上就这些。只要结构体字段标签写对,读写JSON非常直观。注意检查解码错误,避免客户端传错格式导致服务崩溃。对于复杂场景,可结合中间件统一处理JSON编解码逻辑。










